fs-mcp

Ein winziger MCP-Server, der sechs Werkzeuge bereitstellt:

1. explore_filesystem(subpath?, glob?) — listet Dateien/Ordner im Stammverzeichnis auf, optional gefiltert nach einem Glob (**/*.js usw.).

2. edit_file(path, edits[], createIfMissing?) — wendet git-artige Zeilenbearbeitungen (ersetzen / einfügen / löschen eines Zeilenbereichs) auf eine Datei unter dem Stammverzeichnis an.

3. create_file(path, content?, overwrite?) — erstellt eine neue Datei mit optionalem Inhalt und legt bei Bedarf übergeordnete Verzeichnisse an.

4. delete_file(path, recursive?) — löscht eine Datei oder ein Verzeichnis unter dem Stammverzeichnis (optional rekursiv für nicht leere Verzeichnisse).

5. read_file(path, startLine?, endLine?) — liest Dateiinhalte, optional auf einen Zeilenbereich begrenzt, mit vorangestellten Zeilennummern.

6. grep(pattern, glob?, useRegex?, caseInsensitive?) — durchsucht Dateien nach Textmustern, mit optionaler Regex-Unterstützung und Glob-Filterung.

Root = das Arbeitsverzeichnis des Prozesses beim Start.

Als globale CLI installieren

npm install
npm link          # or: npm install -g .

Dadurch erhalten Sie einen globalen fs-mcp-Befehl (über das bin-Feld in package.json eingerichtet).

Related MCP server: LocalFS MCP Server

Ausführen

fs-mcp                 # stdio mode (default) — for Claude Desktop/Code,
                        # which spawn the process themselves
fs-mcp --http          # HTTP mode on http://localhost:4823/mcp — for
                        # curl, the MCP Inspector, or the on-demand
                        # Claude Desktop setup below
fs-mcp --http -p 5000   # custom port
fs-mcp --help

Das Verzeichnis, in dem Sie sich beim Ausführen befinden, wird zum freigegebenen Root.

Verbinden mit Claude Desktop

Claude Desktop startet MCP-Server selbst und kommuniziert über stdio – es übernimmt nicht das aktuelle Verzeichnis Ihres Terminals. Das bietet Ihnen zwei Einrichtungsoptionen, je nachdem, wie Sie arbeiten möchten:

Option A – bei Bedarf aus jedem Ordner (empfohlen, wenn Sie das CLI-Gefühl möchten)

Konfigurieren Sie Desktop einmalig, zeigen Sie auf einen festen lokalen Port statt auf einen festen Ordner. Siehe claude_desktop_config.example.json – fügen Sie dessen "fs-mcp"-Eintrag in Ihr bestehendes mcpServers-Objekt ein unter:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

• Linux: ~/.config/Claude/claude_desktop_config.json

Starten Sie Claude Desktop einmal neu. Ab dann:

cd ~/whatever/project
fs-mcp --http

Dieser Ordner ist nun das, was Claude sehen kann, solange der Server läuft. Beenden Sie ihn mit Ctrl+C und starten Sie ihn erneut aus einem anderen Ordner, um den Kontext zu wechseln – keine weiteren Desktop-Konfigurationsänderungen erforderlich.

Hinweis: --allow-http ist erforderlich, da mcp-remote (die stdio↔HTTP-Brücke) standardmäßig HTTPS + OAuth für echte Remote-Server erwartet; dieses Flag teilt ihm mit, dass einfacher unauthentifizierter localhost-Verkehr in Ordnung ist.

Option B – ein fester Ordner, immer verfügbar

Wenn Sie es vorziehen, dass Desktop immer dasselbe Projekt bereitstellt, ohne manuell etwas starten zu müssen:

{
  "mcpServers": {
    "fs-mcp": {
      "command": "fs-mcp",
      "cwd": "/absolute/path/to/the/folder/you/want/exposed"
    }
  }
}

Starten Sie Desktop neu. Dies verwendet den stdio-Modus direkt – kein Proxy, kein manueller fs-mcp --http-Schritt – aber das Ändern des freigegebenen Ordners bedeutet, diese Konfiguration zu bearbeiten und Desktop erneut neu zu starten.

Sicherheitshinweise

• Jeder Pfad wird gegen das Root aufgelöst und abgelehnt, wenn er es verlassen würde (z. B. ../../etc/passwd) – verifiziert mit einem Path-Traversal-Test.

• Es gibt keine Authentifizierung. Alles, was den Server erreichen kann (jeder lokale Prozess, im --http-Modus), kann jede Datei unter dem Root lesen und schreiben. Für vertrauenswürdige lokale Entwicklung in Ordnung; führen Sie es nicht an einem sensiblen Ort aus und binden Sie es nicht über localhost hinaus.

Bearbeitungssemantik (edit_file)

Bearbeitungen sind {startLine, endLine, newLines}, 1-basiert und inklusiv:

• Ersetzen Sie Zeilen 3–5: {startLine: 3, endLine: 5, newLines: ["new content"]}

• Löschen Sie Zeilen 3–5: {startLine: 3, endLine: 5, newLines: []}

• Fügen Sie vor Zeile 6 ein (keine Löschung): {startLine: 6, endLine: 5, newLines: ["inserted"]}

Mehrere Bearbeitungen in einem Aufruf werden intern von unten nach oben angewendet, sodass sich die Zeilennummern in Ihrer Bearbeitungsliste nicht verschieben, wenn frühere Bearbeitungen angewendet werden.