Files MCP Server
by abhishekkumar2021io.github.Abhishekkumar2021/filesv0.2.0
MCP server for the local filesystem — read, search, edit, copy, archive, and safely manage files within sandboxed roots, from any MCP client.
context tax
queued
security
queued
cold start
queued
freshness
Slowing3mo ago
Install Files MCP server
Install in Claude Code
claude mcp add files -e FS_ROOTS='<fs-roots>' -- npx -y @abhishekmcp/filesInstall in Cursor
{
"mcpServers": {
"files": {
"command": "npx",
"args": [
"-y",
"@abhishekmcp/files"
],
"env": {
"FS_ROOTS": "<fs-roots>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"files": {
"command": "npx",
"args": [
"-y",
"@abhishekmcp/files"
],
"env": {
"FS_ROOTS": "<fs-roots>"
}
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"files": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@abhishekmcp/files"
],
"env": {
"FS_ROOTS": "<fs-roots>"
}
}
}
}Add to .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"files": {
"command": "npx",
"args": [
"-y",
"@abhishekmcp/files"
],
"env": {
"FS_ROOTS": "<fs-roots>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| FS_ROOTS | yes | — | Allowed root directories (comma-separated). Required — the server refuses to start without it. |
| FS_READONLY | — | — | Set to 1 or true to disable all file-modifying tools. |
Freshness
Slowing — last maintenance signal 3mo ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-07-04 · 3mo ago · GitHub
Latest release
2026-07-04 · 3mo ago · GitHub · http-v0.1.0
Package published
no data · npm/PyPI
Registry entry updated
2026-06-28 · 3mo ago · official registry · v0.2.0
FAQ
›How do I install the Files MCP server in Claude Code?
Run: claude mcp add files -e FS_ROOTS='<fs-roots>' -- npx -y @abhishekmcp/files. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does Files require an API key?
Yes. It expects FS_ROOTS.
›Can I use Files as a remote (hosted) MCP server?
No hosted endpoint is published; it runs locally over stdio.
›Is Files in the official MCP registry?
Yes, as io.github.Abhishekkumar2021/files.
Alternatives to Files
Other file system MCP servers.