Fs MCP Rs
A fast, configurable filesystem server for the Model Context Protocol (MCP), written in Rust. Its 20 documented tools cover terminal, file, directory, close. It runs locally over stdio via the published package.
People connecting filesystem tools to Claude, Cursor, VS Code, or another MCP client. The project is written in Rust.
VERIFIED ACTIVE
LAST COMMIT 2026-08-01 · ★ 5 · #9 OF 34 MAINTAINED FILESYSTEM · VERIFIED 2026-08-25
NOASSERTION · Rust servers · how we verify → /methodology
01 · Install Fs MCP Rs
before you install - you'll need
Set FS_MCP_CONFIG, RUST_LOG before connecting.
Claude Code
claude mcp add nihmadev-fs-mcp-rs -- npx -y fs-mcp-rs Claude Desktop / Cursor / VS Code - add to config
{
"mcpServers": {
"nihmadev-fs-mcp-rs": {
"command": "npx",
"args": [
"-y",
"fs-mcp-rs"
]
}
}
} Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.
Using another client? Same JSON, different key
Claude Desktop · mcpServers
Cursor · mcpServers
VS Code · servers
Windsurf · mcpServers
Zed · context_servers
Cline · mcpServers
Roo Code · mcpServers
Continue · mcpServers
LibreChat · mcpServers
Gemini CLI · mcpServers
Codex CLI · mcp_servers
Full setup guides: every client.
02 · Evidence
Security posture
What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.
runs as local process (stdio) - runs on your machine with your user's permissions
repo age created 2026-07-23 - young repo, little track record yet
license no standard license detected - usage rights unclear; check the repo before commercial use
npm package fs-mcp-rs - unscoped; check the name against the project README before installing
registry namespace io.github.nihmadev is GitHub-verified and matches the repo owner
03 · What Fs MCP Rs can do
Prose above is summarized from the project's README and registry record - no invented capabilities.
What you can build
With this server connected, an agent can list direct children of a directory, read a UTF-8 byte range with explicit offset and length, find paths whose file name contains a string, and report sanitized effective limits, roots, protocol versions, and advertised tools.
Capability map
Tools grouped from the project's README - what Fs MCP Rs lets an agent do.
Terminal
6 tools - e.g. start a persistent command and immediately return a session ID.; incrementally read stdout/stderr events using a byte cursor; optionally long-poll for new output.; write UTF-8 data to a running session's…
terminal_start · terminal_read · terminal_write · terminal_close_stdin · terminal_kill · terminal_close
read & search
4 tools - e.g. find paths whose file name contains a string.; case-insensitive literal or regex search in text files.; report sanitized effective limits, roots, protocol versions, and advertised tools.
search_files · search_content · get_capabilities · list_tree
File
3 tools - e.g. read a UTF-8 byte range with explicit offset and length.; return rich metadata and an optional bounded-streaming BLAKE3 digest.; calculate a BLAKE3 file hash.
read_file · file_info · hash_file
Directory
2 tools - e.g. list direct children of a directory.; create one directory; parents must already exist.
list_directory · create_directory
update
2 tools - e.g. move without overwriting an existing destination.; replace an exact expected number of text matches atomically.
move · edit_text
Apply
1 tool - e.g. atomically apply a validated single-file unified text diff; dryRun never mutates.
apply_patch
delete
1 tool - e.g. remove one file or an empty directory.
remove
run & execute
1 tool - e.g. execute an arbitrary shell command with optional working directory and timeout, waiting for completion for backward compatibility.
run_command
Latest releases
v1.2.7 · 2026-08-01
v1.2.6 · 2026-07-31
v1.2.3 · 2026-07-31
04 · Who maintains Fs MCP Rs
fs-mcp-rs is maintained by nihmadev. It's the only MCP server we track from this author; the repo dates to Jul 2026.
05 · Facts
- repository
- github.com/nihmadev/fs-mcp-rs
- category
- filesystem - ranked #9 of 34 actively-maintained filesystem servers as of 2026-08-25.
- release cadence
- 6 releases in the last 90 days (latest 2026-08-01)
- registry
- io.github.nihmadev/fs-mcp-rs (active, first published 2026-07-24)
- packages
- npm:fs-mcp-rs
06 · Fs MCP Rs FAQ
Is Fs MCP Rs still maintained?
Yes - as of 2026-08-25, its last commit was 2026-08-01 and it shipped 6 releases in the last 90 days. We re-verify nightly.
What can Fs MCP Rs do?
With this server connected, an agent can list direct children of a directory, read a UTF-8 byte range with explicit offset and length, find paths whose file name contains a string, and report sanitized effective limits, roots, protocol versions, and advertised tools.
How do I install Fs MCP Rs?
Run `npx -y fs-mcp-rs`. The README documents 2 environment variables (FS_MCP_CONFIG, RUST_LOG) to set first. Set FS_MCP_CONFIG, RUST_LOG before connecting. You can also paste the ready-made client config above.
Does Fs MCP Rs run locally?
Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.
07 · Alternatives to Fs MCP Rs
Alternatives to Fs MCP Rs
Maintained filesystem servers if Fs MCP Rs isn't the fit.
- Server Filesystem MCP server for filesystem access ★ 38,704 · 2026-08-05
- Remote Filesystem MCP server for remote filesystem operations on cloud storage (Google Cloud Storage). ★ 77 · 2026-07-26
- X402 List MCP x402-list directory MCP: services, facilitator volume, ranked picks, paid assessments. ★ 58 · 2026-07-28
- Document Reader An MCP enabled multi-format document reader supporting DOCX, PDF, TXT, and Excel files ★ 23 · 2026-03-13
- File Tools Non-UTF-8 files: CP1251, CP1252, KOI8, ISO-8859, UTF-16, GBK auto-detected and preserved ★ 21 · 2026-08-19
- Phantom Secrets Stop AI coding agents from leaking API keys. Local proxy swaps real secrets for phm_ tokens. ★ 16 · 2026-08-19
More filesystem MCP servers · Sshmcp · Server Cloud Fs · Lossless Context MCP · p6xer MCP Server
More Rust MCP servers · Diffctx · Pump SDK MCP Server · Kg · Regex LE · Dynoxide · see all