Skip to main content

An MCP server for reading and writing files from your local file system

Project description

MCP File Server

An MCP server for reading and writing files from your local file system. This server can be used with Claude for Desktop or any other MCP client to provide file system access for AI assistants.

Features

  • List files and directories
  • Read file contents
  • Write content to files
  • Delete files and directories

Prerequisites

  • Docker installed on your system
  • Git (optional, for cloning the repository)

Setup and Deployment

Option 1: Using Docker Compose (Recommended)

  1. Clone this repository:

    git clone https://github.com/abhishekloiwal/mcp-file-server.git
    cd mcp-file-server
    
  2. Edit the docker-compose.yml file to update the volume mount path if needed. By default, it's set to:

    volumes:
      - /Users/abhishekloiwal/CascadeProjects/ClaudeProjects:/data
    

    Replace with your desired local path if different.

  3. Deploy with Docker Compose:

    docker-compose up -d
    

Option 2: Using Docker directly

  1. Clone the repository:

    git clone https://github.com/abhishekloiwal/mcp-file-server.git
    cd mcp-file-server
    
  2. Build the Docker image:

    docker build -t mcp-file-server .
    
  3. Run the container with your local directory mounted:

    docker run -d --name mcp-file-server -v /Users/abhishekloiwal/CascadeProjects/ClaudeProjects:/data mcp-file-server
    

    Replace the path with your desired local directory path.

Connecting to Claude for Desktop

  1. Create or update your Claude for Desktop configuration file at:

    • Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %AppData%\Claude\claude_desktop_config.json
  2. Add the mcp-file-server to your configuration:

    {
      "mcpServers": {
        "file-server": {
          "command": "docker",
          "args": ["exec", "-i", "mcp-file-server", "python", "server.py"]
        }
      }
    }
    
  3. Restart Claude for Desktop.

  4. You should now see the file-server tools available in Claude.

Available Tools

The following tools are available through this MCP server:

  • list_files: List all files in a directory
  • read_file: Read the contents of a file
  • write_file: Write content to a file
  • delete_file: Delete a file or directory

License

MIT

Troubleshooting

  • If Claude for Desktop doesn't connect to the server, check the Docker container status:

    docker ps -a | grep mcp-file-server
    
  • View server logs:

    docker logs mcp-file-server
    
  • Make sure the volume is correctly mounted:

    docker inspect mcp-file-server | grep -A 10 Mounts
    

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

File details

Details for the file iflow_mcp_abhishekloiwal_mcp_file_server-0.1.1.tar.gz.

File metadata

  • Download URL: iflow_mcp_abhishekloiwal_mcp_file_server-0.1.1.tar.gz
  • Upload date:
  • Size: 3.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.9.27 {"installer":{"name":"uv","version":"0.9.27","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for iflow_mcp_abhishekloiwal_mcp_file_server-0.1.1.tar.gz
Algorithm Hash digest
SHA256 8ca4b5dd4298ac61ee233eb7420e23dda3f85528b231749369306aa22a1f2844
MD5 32b6605c5816a98c915442508c333f7f
BLAKE2b-256 9990f2e7ceb32df74656739645ab3407fa4ebdb1ecc62b04f42b7c0016c1f996

See more details on using hashes here.

File details

Details for the file iflow_mcp_abhishekloiwal_mcp_file_server-0.1.1-py3-none-any.whl.

File metadata

  • Download URL: iflow_mcp_abhishekloiwal_mcp_file_server-0.1.1-py3-none-any.whl
  • Upload date:
  • Size: 8.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.9.27 {"installer":{"name":"uv","version":"0.9.27","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for iflow_mcp_abhishekloiwal_mcp_file_server-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 e0c27ab16f1ff5188893fb6308f7b62fda4ad08638061f12395a7574ec4a6d46
MD5 c5176b16135435f245aa2c2932a95672
BLAKE2b-256 3e6932178704c69510d5e5850e095cae0a209f0b80c4df1934a131c72430c264

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page