MCP Filesystem

Model Context Protocol (MCP) server with a resource for each file in a workspace

Catalog onlyCatalog onlySTDIO

Overview

MCP Filesystem is a Model Context Protocol (MCP) server that exposes resources for each file in a working directory and sends change notifications.

To use MCP Filesystem, install Go, fetch the server, and configure your client to access the MCP resources by specifying the workspace path in the client configuration.

Creates one MCP resource for each file in your workspace - Respects .gitignore rules - Detects file changes, additions, and deletions - Identifies file types and handles various text encodings

Managing file resources in a development environment
Monitoring changes in a project directory
Integrating with clients that support MCP features for file access

Add to your AI client

Use these steps to connect MCP Filesystem in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

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

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

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

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

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

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "mcp-filesystem-isaacphi": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-filesystem-isaacphi"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

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

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

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

FAQ

What programming language is MCP Filesystem written in?

MCP Filesystem is written in Go.

Is there support for additional ignore patterns beyond `.gitignore`?

Currently, only `.gitignore` is supported, but future updates may include more options.

How can I report issues or provide feedback?

You can submit issues on the project's GitHub repository with as many details as possible.

File systems