MCP Server Filesystem

🚀 MCP File System Server

This is an unofficial port of the Claude file system MCP server implementation, serving only as a Proof of Concept (POC). This project has no affiliation with Anthropic and should not be used in a production environment. It is designed to demonstrate and explore the functionality of the MCP server.

🚀 Quick Start

Installation with UVX

uv venv
.venv\Scripts\activate  # Run on Windows systems
uv pip install -e .

💻 Usage in Claude Desktop

1. Edit your claude_desktop_config.json file

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

You can add multiple directories:

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

2. Restart Claude Desktop to apply the changes

3. In Claude Desktop

• Click the paperclip icon.
• Select the MCP menu (two connected electrical plugs).
• Your file system server will be displayed in the integration options.

⚠️ Security Note

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

🔧 Troubleshooting

1. Command not found

• Ensure the package is installed (check using uv pip list).
• Confirm that the Python environment is activated.

2. Access denied

• Verify that the directories in args exist.
• Ensure you have read permissions for the specified directories.

3. Server not displayed in Claude Desktop

• Check the syntax of the configuration file for errors.
• Restart Claude Desktop after making configuration changes.