MCP-Dateisystemserver

Dieser MCP-Server bietet sicheren Zugriff auf das lokale Dateisystem über das Model Context Protocol (MCP).

Komponenten

Werkzeuge

Dateioperationen

• Datei lesen

  • Lesen Sie den gesamten Inhalt einer Datei aus dem Dateisystem

  • Parameter: path (erforderlich): Pfad zur zu lesenden Datei

• mehrere Dateien lesen

  • Lesen Sie den Inhalt mehrerer Dateien in einem einzigen Vorgang

  • Parameter: paths (erforderlich): Liste der zu lesenden Dateipfade

• Datei schreiben

  • Erstellen Sie eine neue Datei oder überschreiben Sie eine vorhandene Datei mit neuem Inhalt

  • Parameter: path (erforderlich): Pfad, in den die Datei geschrieben werden soll, content (erforderlich): Inhalt, der in die Datei geschrieben werden soll

• Datei kopieren

  • Dateien und Verzeichnisse kopieren

  • Parameter: source (erforderlich): Quellpfad der Datei oder des Verzeichnisses, destination (erforderlich): Zielpfad

• Datei verschieben

  • Verschieben oder Umbenennen von Dateien und Verzeichnissen

  • Parameter: source (erforderlich): Quellpfad der Datei oder des Verzeichnisses, destination (erforderlich): Zielpfad

• Datei löschen

  • Löschen einer Datei oder eines Verzeichnisses aus dem Dateisystem

  • Parameter: path (erforderlich): Pfad zur zu löschenden Datei oder zum zu löschenden Verzeichnis, recursive (optional): Ob Verzeichnisse rekursiv gelöscht werden sollen (Standard: false)

Verzeichnisvorgänge

• Verzeichnisliste

  • Erhalten Sie eine detaillierte Auflistung aller Dateien und Verzeichnisse in einem angegebenen Pfad

  • Parameter: path (erforderlich): Pfad des aufzulistenden Verzeichnisses

• Verzeichnis erstellen

  • Erstellen Sie ein neues Verzeichnis oder stellen Sie sicher, dass ein Verzeichnis vorhanden ist

  • Parameter: path (erforderlich): Pfad des zu erstellenden Verzeichnisses

• Baum

  • Gibt eine hierarchische JSON-Darstellung einer Verzeichnisstruktur zurück

  • Parameter: path (erforderlich): Pfad des zu durchlaufenden Verzeichnisses, depth (optional): Maximale zu durchlaufende Tiefe (Standard: 3), follow_symlinks (optional): Ob symbolischen Links gefolgt werden soll (Standard: false)

Suche und Information

• Suchdateien

  • Rekursive Suche nach Dateien und Verzeichnissen, die einem Muster entsprechen

  • Parameter: path (erforderlich): Startpfad für die Suche, pattern (erforderlich): Suchmuster zum Abgleichen mit Dateinamen

• Dateiinformationen abrufen

  • Abrufen detaillierter Metadaten zu einer Datei oder einem Verzeichnis

  • Parameter: path (erforderlich): Pfad zur Datei oder zum Verzeichnis

• Liste zulässiger Verzeichnisse

  • Gibt die Liste der Verzeichnisse zurück, auf die dieser Server zugreifen darf

  • Parameter: Keine

Related MCP server: godoc-mcp

Merkmale

• Sicherer Zugriff auf angegebene Verzeichnisse

• Pfadvalidierung zur Verhinderung von Directory-Traversal-Angriffen

• Symlink-Auflösung mit Sicherheitsüberprüfungen

• MIME-Typ-Erkennung

• Unterstützung für Text-, Binär- und Bilddateien

• Größenbeschränkungen für Inline-Inhalte und Base64-Kodierung

Erste Schritte

Installation

Verwenden von Go Install

go install github.com/mark3labs/mcp-filesystem-server@latest

Verwendung

Als eigenständiger Server

Starten Sie den MCP-Server mit zulässigen Verzeichnissen:

mcp-filesystem-server /path/to/allowed/directory [/another/allowed/directory ...]

Als Bibliothek in Ihrem Go-Projekt

package main

import (
	"log"
	"os"

	"github.com/mark3labs/mcp-filesystem-server/filesystemserver"
)

func main() {
	// Create a new filesystem server with allowed directories
	allowedDirs := []string{"/path/to/allowed/directory", "/another/allowed/directory"}
	fs, err := filesystemserver.NewFilesystemServer(allowedDirs)
	if err != nil {
		log.Fatalf("Failed to create server: %v", err)
	}

	// Serve requests
	if err := fs.Serve(); err != nil {
		log.Fatalf("Server error: %v", err)
	}
}

Verwendung mit Model Context Protocol

So integrieren Sie diesen Server in Apps, die MCP unterstützen:

{
  "mcpServers": {
    "filesystem": {
      "command": "mcp-filesystem-server",
      "args": ["/path/to/allowed/directory", "/another/allowed/directory"]
    }
  }
}

Docker

Ausführen mit Docker

Sie können den Filesystem-MCP-Server mit Docker ausführen:

docker run -i --rm ghcr.io/mark3labs/mcp-filesystem-server:latest /path/to/allowed/directory

Docker-Konfiguration mit MCP

So integrieren Sie das Docker-Image in Apps, die MCP unterstützen:

{
  "mcpServers": {
    "filesystem": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/mark3labs/mcp-filesystem-server:latest",
        "/path/to/allowed/directory"
      ]
    }
  }
}

Lizenz

Weitere Einzelheiten finden Sie in der Datei LICENSE .