Filesystem MCP Server
Reference MCP server for reading, writing, searching and moving files inside directories you explicitly allow.
- Autor
- Model Context Protocol
- Funktioniert mit
- Any MCP client
- Lizenz
- MIT
- Dokumentiert
- Oct 2, 2026
Was Filesystem MCP Server ist
Node.js server implementing MCP for filesystem operations, published on npm as @modelcontextprotocol/server-filesystem. Access is limited to allowed directories given as command-line arguments or via MCP Roots.
Was es kann
- Read text files (with head/tail options) and media files
- Read multiple files at once
- Write and overwrite files
- Create, list and delete directories and move files or directories
- Search files and get file metadata
- Update allowed directories at runtime through MCP Roots
Wann Sie es einsetzen sollten
Gut geeignet
- Letting an agent work on a few specific project folders
- Clients that support Roots and need runtime directory changes
Nicht geeignet für
- Anything needing access outside the allowed directories
- Production use without your own review: The root README says these are reference implementations meant as educational examples, not production-ready solutions.
So installieren Sie Filesystem MCP Server
Sie benötigen: Node.js (npx); At least one allowed directory via arguments or Roots, otherwise it errors on start
- Make sure Node.js and npx are available
- Add the server to your MCP client config with the npx command
- Pass at least one allowed directory as an argument, or use a client that supports Roots
- Restart the client and call list_allowed_directories to confirm
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"/path/to/dir1",
"/path/to/dir2"
]
}
}
}Berechtigungen und Sicherheit
Worauf es zugreifen kann
- Read and write files and directories inside allowed directories only
Sicherheitshinweise der Maintainer
- write_file overwrites existing files; README says to exercise caution
- The root README says these are reference implementations meant as educational examples, not production-ready solutions.
Prüfen Sie den Quellcode, bevor Sie einem Agenten Zugriff auf Zugangsdaten oder Produktivsysteme geben. Wir dokumentieren die Angaben der Maintainer; Code prüfen wir nicht.
Einschränkungen
- Server errors on startup if no args are given and the client does not support Roots
- Roots from the client completely replace command-line directories
Häufig gestellte Fragen
What does the Filesystem MCP server need to start?
At least one allowed directory, passed as an argument or supplied by the client through Roots. Quelle
Can the Filesystem MCP server access files outside the allowed directories?
No. The README says all operations are restricted to allowed directories. Quelle
What is the npm package for the Filesystem MCP server?
@modelcontextprotocol/server-filesystem. Quelle
Verwandte Ratgeber
Quellen und Lücken
- https://raw.githubusercontent.com/modelcontextprotocol/servers/main/src/filesystem/README.md readme, geprüft Oct 2, 2026
- https://raw.githubusercontent.com/modelcontextprotocol/servers/main/README.md readme, geprüft Oct 2, 2026
Von den Maintainern nicht angegeben: Hosts other than generic MCP clients are not individually named as supported for Claude Code/Cursor/Windsurf/Codex in this README; last_release date not visible in the checked README.