drio
Open app

MCP Filesystem Server

Source

Catalog onlyCatalog onlySTDIO

Overview

MCP Filesystem Server is an unofficial proof of concept for implementing a filesystem server that integrates with Claude's MCP server functionality. It is designed for educational purposes and is not intended for production use.

To use MCP Filesystem Server, install it using the UVX package manager, configure your directories in the claude_desktop_config.json file, and integrate it with Claude Desktop.

  • Easy installation using UVX - Integration with Claude Desktop for file management - Strict path validation for security - Configurable to support multiple directories
  1. Integrating local file storage with Claude's capabilities.
  2. Demonstrating concepts of server functionality in educational settings.
  3. Developing and testing features related to filesystem management.

Add to your AI client

Use these steps to connect MCP Filesystem Server 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-server-filesystem-philgei": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-server-filesystem-philgei"
      ]
    }
  }
}

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-server-filesystem-philgei": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-server-filesystem-philgei"
      ]
    }
  }
}

Claude Code

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

.mcp.json (project root)

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

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-server-filesystem-philgei": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-server-filesystem-philgei"
      ]
    }
  }
}

Windsurf

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

~/.codeium/windsurf/mcp_config.json

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

Cline

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

Cline MCP Settings (via UI)

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

FAQ

Is this project affiliated with Anthropic?

No, this project is an unofficial port and is not affiliated with Anthropic.

Can I use this in production?

No, this project is intended as a proof of concept and should not be used in production environments.

How do I troubleshoot common issues?

Refer to the troubleshooting section in the documentation for solutions to common errors.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":242,"uuid":"0c9d1d1e-9672-4b0d-b141-206c0a64d79b","name":"mcp_server_filesystem","title":"MCP Filesystem Server","description":null,"avatar_url":"https://avatars.githubusercontent.com/u/11510925?v=4","created_at":"2024-12-13T10:40:19.816Z","updated_at":"2024-12-13T12:28:11.268Z","status":"created","author_name":"philgei","author_avatar_url":"https://avatars.githubusercontent.com/u/11510925?v=4","tags":"[]","category":"file-systems","is_featured":false,"sort":1,"url":"https://github.com/philgei/mcp_server_filesystem","target":"_self","content":"$29","summary":"$2a","img_url":null,"type":null,"metadata":null,"user_uuid":null,"tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]

File systems