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)
-
Clone this repository:
git clone https://github.com/abhishekloiwal/mcp-file-server.git cd mcp-file-server
-
Edit the
docker-compose.ymlfile 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.
-
Deploy with Docker Compose:
docker-compose up -d
Option 2: Using Docker directly
-
Clone the repository:
git clone https://github.com/abhishekloiwal/mcp-file-server.git cd mcp-file-server
-
Build the Docker image:
docker build -t mcp-file-server .
-
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
-
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
- Mac:
-
Add the mcp-file-server to your configuration:
{ "mcpServers": { "file-server": { "command": "docker", "args": ["exec", "-i", "mcp-file-server", "python", "server.py"] } } }
-
Restart Claude for Desktop.
-
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 directoryread_file: Read the contents of a filewrite_file: Write content to a filedelete_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
Release history Release notifications | RSS feed
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
17b03d74f727cc41004a7228509bc17c6b52281ebffe1efc1c6a0453f4dc119f
|
|
| MD5 |
8da2d92000ee3920f7822efd87b7eaf1
|
|
| BLAKE2b-256 |
da8fd7f38f44a0df5a94d6b53ed6cf0197e545fc5bfe8b835e3961fa6c83a5f6
|