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

File details

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

File metadata

  • Download URL: iflow_mcp_abhishekloiwal_mcp_file_server-0.1.0.tar.gz
  • Upload date:
  • Size: 3.1 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.0.tar.gz
Algorithm Hash digest
SHA256 17b03d74f727cc41004a7228509bc17c6b52281ebffe1efc1c6a0453f4dc119f
MD5 8da2d92000ee3920f7822efd87b7eaf1
BLAKE2b-256 da8fd7f38f44a0df5a94d6b53ed6cf0197e545fc5bfe8b835e3961fa6c83a5f6

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