Filesystem Context MCP Server

Filesystem-MCP is a Model Context Protocol server that lets AI assistants read and write files within explicitly allowed directories. Sensitive file patterns (.env, .pem, id_rsa) are blocked by default. It exposes filesystem tools, resources, and prompts over stdio or Streamable HTTP transport. Its 13 documented tools cluster into read & search, update, stat, diff.

People who work with filesystem, search and file management and want it reachable from Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

NO LONGER MAINTAINED

LAST COMMIT 2026-09-30 · ★ 23 · VERIFIED 2026-09-30

MIT · TypeScript servers · how we verify → /methodology

01 · Install Filesystem Context

before you install - you'll need

FS_ALLOWED_DIRS

Environment variables documented in the project's README - it lists which are required and which have defaults.

Claude Code

claude mcp add j0hanz-filesystem-context-mcp-server -- npx -y @j0hanz/filesystem-context-mcp

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "j0hanz-filesystem-context-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@j0hanz/filesystem-context-mcp"
      ]
    }
  }
}

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

license MIT - declared in the repository

npm package @j0hanz/filesystem-context-mcp - published under the repo owner's npm scope (@j0hanz)

registry namespace io.github.j0hanz is GitHub-verified and matches the repo owner

03 · What Filesystem Context 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 allowed workspace roots. Call this first - all other tools scope to these, list directory contents. Returns entries (dirs-first, alphabetical) and an ASCII tree, find files by glob pattern (e.g. /.ts). Returns matching files with metadata, and get file/directory metadata: size, modified time, permissions, MIME type, token estimate.

Capability map

Tools grouped from the project's README - what Filesystem Context lets an agent do.

read & search

5 tools - e.g. List allowed workspace roots. Call this first - all other tools scope to these.; List directory contents. Returns entries (dirs-first, alphabetical) and an ASCII tree.; Find files by glob pattern (e.g.…

list_roots · list · find_files · search_text · read

update

3 tools - e.g. Apply sequential literal string replacements to one or more files (up to 5 files per call, 100 edits per file).; Move, rename, or copy (copy: true) one or more files/directories to explicit destinations.…

edit · move · patch

Stat

1 tool - e.g. Get file/directory metadata: size, modified time, permissions, MIME type, token estimate.

stat

Diff

1 tool - e.g. Compare two files and return a unified diff with added/removed line counts.

diff

create & write

1 tool - e.g. Create one or more files, creating parent directories as needed. An existing file prompts the user to confirm the overwrite; overwrite: true on an entry skips t

create

delete

1 tool - e.g. Permanently delete one or more files or directories. This action is irreversible.

delete

Replace

1 tool - e.g. Bulk search-and-replace across files matching a glob pattern.

replace_text

Latest releases

v2.7.0 · 2026-09-29

A feature and hardening release. Two security fixes close fail-open gaps in · the sensitive-file policy and the root boundary, resource links and write · results now carry modification times, --print-config reports the…

v2.6.3 · 2026-09-28

A small release for plugin hosts. A root argument written as ${NAME} now · reads that variable from the environment, which lets the Copilot CLI and · Antigravity CLI plugins start the server with the project as its…

v2.6.2 · 2026-09-28

A fix release so the server starts on runtimes older than Node 24. Nothing · changes on Node 24 and later, and the declared surface (tools, capabilities, · instructions, prompts, resources) is identical to 2.6.1.…

04 · Who maintains Filesystem Context

filesystem-context is maintained by j0hanz. We track 9 MCP servers from j0hanz - 8 actively maintained, 47 combined GitHub stars, oldest repo from Dec 2025. Full record: all servers from j0hanz.

Filesystem MCP Secure filesystem MCP server for reading, writing, searching, diffing, and patching files. ★ 23

05 · Facts

repository: github.com/j0hanz/filesystem-context-mcp-server
category: filesystem - dead as of 2026-09-30.
release cadence: 10+ releases in the last 90 days (latest 2026-09-29)
registry: io.github.j0hanz/filesystem-context (deprecated, first published 2025-12-12)
packages: npm:@j0hanz/filesystem-context-mcp

06 · Filesystem Context FAQ

Is Filesystem Context still maintained?

Its last commit was 2026-09-30 (as of 2026-09-30) - we classify it as dead.

What can Filesystem Context do?

How do I install Filesystem Context?

Run `npx -y @j0hanz/filesystem-context-mcp`. The README documents one environment variable (FS_ALLOWED_DIRS) to set first. You can also paste the ready-made client config above.

Does Filesystem Context 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 Filesystem Context

Alternatives to Filesystem Context

Maintained filesystem servers if Filesystem Context isn't the fit.