FileSystem-MCP

A sandboxed file-management MCP server for Claude Desktop.

| Tool | Description | |------|-------------| | list_files(subdir) | List files & folders | | read_file(file_path) | Read text content | | write_file(file_path, content) | Create or overwrite a file | | delete_file(file_path) | Delete a file | | search_files(keyword, extension) | Search by keyword across files |

uv sync
uv run python main.py

docker build -t filesystem-mcp .
docker run --rm -i -v /your/local/sandbox:/app/sandbox filesystem-mcp

> -i is required — MCP uses stdio transport (stdin/stdout).

Edit claude_desktop_config.json:

{
  "mcpServers": {
    "filesystem": {
      "command": "uv",
      "args": ["run", "python", "main.py"],
      "cwd": "/absolute/path/to/this/project",
      "env": {
        "SANDBOX_DIR": "/absolute/path/to/sandbox"
      }
    }
  }
}

{
  "mcpServers": {
    "filesystem": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "-v", "/your/sandbox:/app/sandbox",
        "filesystem-mcp"
      ]
    }
  }
}

| Variable | Default | Description | |----------|---------|-------------| | SANDBOX_DIR | /app/sandbox | Root directory for the sandbox |