Claude debuggt und behebt seinen eigenen MCP-Dateisystem-Server-UNC-Pfad-Fehler unter Windows

Ein Entwickler dokumentierte die Nutzung von Claude Opus, um einen Fehler im MCP Filesystem Server (Desktop-Erweiterungsversion) unter Windows zu debuggen und zu beheben. Das Problem betraf UNC-Netzwerkfreigabepfade (z. B. \\server\share\).

Das Problem

Bei Verwendung einer UNC-Freigabe als erlaubtes Verzeichnis funktionierte list_directory im Freigabestammverzeichnis, aber alle Operationen in Unterverzeichnissen oder mit Dateien schlugen mit einem "Zugriff verweigert - Pfad außerhalb erlaubter Verzeichnisse"-Fehler fehl. Das Schreiben von Dateien in das Stammverzeichnis schlug ebenfalls fehl, obwohl die Freigabe über den Windows-Explorer und Netzlaufwerke vollständig zugänglich war.

Der Debugging-Prozess

Claude half dabei, Folgendes zu identifizieren:

• Die Konfiguration für die Desktop-Erweiterungsversion wird in %APPDATA%\Claude\Claude Extensions Settings\ant.dir.ant.anthropic.filesystem.json gespeichert, nicht in claude_desktop_config.json.
• Das Wechseln zu einem Netzlaufwerksbuchstaben funktionierte nicht, weil Node.js fs.realpath() Netzlaufwerke beim Serverstart wieder in UNC-Pfade auflöst.
• Die Serverquell-Dateien (index.js → lib.js → path-validation.js) wurden untersucht, um die Ursache zu finden.

Ursache

In path-validation.js prüft die Funktion isPathWithinAllowedDirectories() die Unterverzeichniszugehörigkeit mit:

return normalizedPath.startsWith(normalizedDir + path.sep);

UNC-Freigabestammverzeichnisse sind Dateisystemstämme (wie C:\) und behalten ihren nachgestellten Backslash nach der Normalisierung: \\server\share\. Dies erzeugt einen doppelten nachgestellten Backslash (\\server\share\\), der nie mit echten Pfaden übereinstimmt. Der Code hatte eine Sonderbehandlung für Laufwerksstämme wie C:\, aber nicht für UNC-Stämme.

Die Korrektur

Ersetzen Sie die problematische Zeile durch:

const dirWithSep = normalizedDir.endsWith(path.sep) ? normalizedDir : normalizedDir + path.sep;
return normalizedPath.startsWith(dirWithSep);

Wenden Sie den Patch mit diesem PowerShell-One-Liner an:

$file = "$env:APPDATA\Claude\Claude Extensions\ant.dir.ant.anthropic.filesystem\node_modules\@modelcontextprotocol\server-filesystem\dist\path-validation.js"
Copy-Item $file "$HOME\Desktop\path-validation.js.backup"
$content = Get-Content $file -Raw
$content = $content.Replace(
  'return normalizedPath.startsWith(normalizedDir + path.sep);',
  'const dirWithSep = normalizedDir.endsWith(path.sep) ? normalizedDir : normalizedDir + path.sep; return normalizedPath.startsWith(dirWithSep);'
)
[System.IO.File]::WriteAllText($file, $content)

Beenden Sie dann Claude Desktop vollständig und starten Sie es neu. Claude testete die Korrektur selbst mit MCP-Tools nach dem Neustart – das Auflisten von Unterverzeichnissen und das Schreiben einer Testdatei bestätigten die Funktionalität.

Hinweis: Dieser Patch wird überschrieben, wenn die Erweiterung automatisch aktualisiert wird. Die Korrektur sollte upstream in @modelcontextprotocol/server-filesystem implementiert werden. Verwandte GitHub-Issues: #1838, #470.