MCP 文件服务器

一个用于从本地文件系统读取和写入文件的MCP服务器。此服务器可以与桌面版Claude或其他任何MCP客户端一起使用，以提供文件系统访问权限给AI助手。

功能

• 列出文件和目录
• 读取文件内容
• 写入文件内容
• 删除文件和目录

预备条件

• 在您的系统上安装Docker
• Git（可选，用于克隆仓库）

安装和部署

方案1：使用Docker Compose（推荐）

1. 克隆此仓库：

   git clone https://github.com/abhishekloiwal/mcp-file-server.git
   cd mcp-file-server
   

2. 编辑docker-compose.yml文件，如果需要的话更新卷挂载路径。默认设置为：

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

   如果不同，请替换为您所需的本地路径。

3. 使用Docker Compose进行部署：

   docker-compose up -d
   

方案2：直接使用Docker

1. 克隆仓库：

   git clone https://github.com/abhishekloiwal/mcp-file-server.git
   cd mcp-file-server
   

2. 构建Docker镜像：

   docker build -t mcp-file-server .
   

3. 运行容器并挂载您的本地目录：

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

   替换路径为您所需的本地目录路径。

连接到桌面版Claude

1. 创建或更新桌面版Claude的配置文件：

   • Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %AppData%\Claude\claude_desktop_config.json

2. 将mcp-file-server添加到您的配置中：

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

3. 重启桌面版Claude。

4. 您现在应该可以在Claude中看到文件服务器工具。

可用工具

通过此MCP服务器提供的以下工具：

• list_files: 列出目录中的所有文件
• read_file: 读取文件的内容
• write_file: 向文件写入内容
• delete_file: 删除文件或目录

许可证

MIT

故障排除

• 如果桌面版Claude无法连接到服务器，请检查Docker容器状态：

  docker ps -a | grep mcp-file-server
  

• 查看服务器日志：

  docker logs mcp-file-server
  

• 确保卷正确挂载：

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