Filesystem MCP Server
by bytedanceio.github.bytedance/mcp-server-filesystemv1.0.0
MCP server for filesystem access
context tax
pending
security
100/100
cold start
pending
freshness
Active10d ago
Our reading of Filesystem, from the data
Filesystem is a file system MCP server from bytedance, listed in the official MCP Registry.
We haven't measured its tool list yet, so its token cost is unknown.
Maintenance is active: the last public signal was 10 days ago (2026-10-09). For comparison, 58% of file system servers are active or maintained.
With 39,318 GitHub stars it ranks #3 of 129 file system servers we index.
It runs either locally over stdio or as a hosted endpoint.
Install Filesystem MCP server
Install in Claude Code
claude mcp add filesystem-bytedance -- npx -y @agent-infra/mcp-server-filesystem allowed-directories '<allowed-directories>'Install in Cursor
{
"mcpServers": {
"filesystem-bytedance": {
"command": "npx",
"args": [
"-y",
"@agent-infra/mcp-server-filesystem",
"allowed-directories",
"<allowed-directories>"
]
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"filesystem-bytedance": {
"command": "npx",
"args": [
"-y",
"@agent-infra/mcp-server-filesystem",
"allowed-directories",
"<allowed-directories>"
]
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"filesystem-bytedance": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@agent-infra/mcp-server-filesystem",
"allowed-directories",
"<allowed-directories>"
]
}
}
}Add to .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"filesystem-bytedance": {
"command": "npx",
"args": [
"-y",
"@agent-infra/mcp-server-filesystem",
"allowed-directories",
"<allowed-directories>"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
Security signals
100/100 — no known issues found as of 2026-10-19, from the checks below. This is not a guarantee of safety; review what a server can do before connecting it.
Deductions
No findings from the checks that ran.
Checks
- ✓Repository hygiene (archived, activity, license, security policy)
- ○Package metadata (install scripts, provenance) — pending
- ○Tool descriptions (prompt-injection and hidden-text heuristics) — pending
- ○Source scan (secrets, CVEs, risky code) by vectra-guard — pending
Scan it yourself before installing with vectra-guard, the open-source agent security CLI. Scoring rules
Freshness
Active — last maintenance signal 10d ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-10-09 · 10d ago · GitHub
Latest release
2026-10-08 · 10d ago · GitHub · v0.3.1
Package published
no data · npm/PyPI
Registry entry updated
2025-09-09 · 14mo ago · official registry · v1.0.0
How it compares in File System
Against the most-starred file system servers we index. Token cost is per model turn, measured from each server's live tool list.
| Server | Stars | Tools | Tokens / turn | Freshness | Runs |
|---|---|---|---|---|---|
| Filesystem (this) | 39,318 | — | not measured | Active | local + hosted |
| Markitdown | 190,947 | — | not measured | Active | — |
| Filesystem | 91,356 | — | not measured | Active | local |
| Plg Handler | 14,805 | — | not measured | Active | — |
| Everything Search | 366 | — | not measured | Active | local |
| LLM Context PY | 307 | — | not measured | Active | — |
FAQ
›How do I install the Filesystem MCP server in Claude Code?
Run: claude mcp add filesystem-bytedance -- npx -y @agent-infra/mcp-server-filesystem allowed-directories '<allowed-directories>'. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does Filesystem require an API key?
No required environment variables are declared in its published metadata.
›Can I use Filesystem as a remote (hosted) MCP server?
Yes — it offers both a hosted endpoint and a local stdio package.
›Is Filesystem in the official MCP registry?
Yes, as io.github.bytedance/mcp-server-filesystem.
Sources and method
- Official MCP Registry entry
- updated 2025-09-09
- GitHub repository
- fetched 2026-10-19
- Package registry (npm / PyPI)
- listed
- Security signals, computed by us
- 2026-10-19
- Last checked against all sources
- 2026-10-19
The description, packages and links come from the maintainer's own published metadata. Token cost, security signals, freshness and the reading above are MCPSkillHub's own measurements; see the methodology. Spot an error? Request a correction or claim the listing.
Alternatives to Filesystem
Other file system MCP servers.
MarkitdownActiveConvert many file formats, local or remote, to Markdown for LLMs using MarkItDown.
FilesystemActiveSecure file operations with configurable access controls
Plg HandlerActiveRemote storage access: SFTP, S3, FTP, SMB, NFS, WebDAV, Git, FTPS, Google Cloud, Azure Blob, SharePoint and more.
Everything SearchActiveFast file search: Everything SDK on Windows, Spotlight (mdfind) on macOS, locate/plocate on Linux.
LLM Context PYActiveShare code context with LLMs via Model Context Protocol or clipboard.
GdriveAbandonedMCP server for interacting with Google Drive and Sheets