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

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

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