Use This MCP server To

Expose local files to LLMs for browsing and reading Enable AI-assisted code and document exploration Provide real-time file context for AI workflows Integrate local filesystem data into AI copilots Experiment with MCP server functionality for filesystems

README

MCP Filesystem Server

DISCLAIMER: This is an unofficial port of Claude's filesystem MCP server implementation, created solely as a Proof of Concept (POC). This project is not affiliated with Anthropic and should not be used in production environments. It was created to demonstrate and explore MCP server functionality.

The original implementation and concept were demonstrated by Claude (Anthropic) during interactive sessions. This port serves educational purposes only.

Quick Start

Install using UVX:

uv venv
.venv\Scripts\activate  # On Windows
uv pip install -e .

Usage with Claude Desktop

Edit your claude_desktop_config.json:

{
  "mcpServers": {
    "myFiles": {
      "command": "mcp-server-filesystem",
      "args": [
        "D:/"  // Replace with your desired directory
      ]
    }
  }
}

You can add multiple directories:

{
  "mcpServers": {
    "myFiles": {
      "command": "mcp-server-filesystem",
      "args": [
        "D:/",
        "C:/Users/YourUsername/Documents",
        "~/Desktop"
      ]
    }
  }
}

Restart Claude Desktop to apply changes
In Claude Desktop:
- Click the paperclip icon
- Select the MCP menu (two electrical plugs connecting)
- Your filesystem server will be available in the integrations

Security Note

Only directories specified in the args array will be accessible. The server enforces strict path validation to prevent access outside allowed directories.

Troubleshooting

Command not found:
- Make sure the package is installed (uv pip list)
- Check your Python environment is activated
Access denied:
- Verify the directories in args exist
- Ensure you have read permissions for specified directories
Server not showing in Claude Desktop:
- Check your config file syntax
- Restart Claude Desktop after config changes

mcp_server_filesystem FAQ

How do I install the mcp_server_filesystem?

Install using UVX by creating a virtual environment and running 'uv pip install -e .' as shown in the quick start guide.

Can I serve multiple directories with mcp_server_filesystem?

Yes, you can configure multiple directories by adding them as arguments in the MCP server configuration JSON.

Is mcp_server_filesystem suitable for production use?

No, this is an unofficial Proof of Concept intended for educational and experimental purposes only.

How do I configure mcp_server_filesystem with Claude Desktop?

Edit the 'claude_desktop_config.json' file to add the server command and directory paths under 'mcpServers'.

Does mcp_server_filesystem support real-time file updates?

It provides real-time access to the filesystem, but specific update handling depends on the client integration.

Is this MCP server affiliated with Anthropic?

No, this is an unofficial port and is not affiliated with Anthropic or the original Claude implementation.

What LLM providers can use mcp_server_filesystem?

While demonstrated with Claude, it can be integrated with other MCP-compatible LLMs like OpenAI's GPT-4 and Google's Gemini.