MCP 文件服务器

一个 MCP 服务器，用于从本地文件系统读取和写入文件。此服务器可以与 Claude for Desktop 或任何其他 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 for Desktop

1. 在以下位置创建或更新您的 Claude for Desktop 配置文件：

   • 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 for Desktop。

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

可用工具

以下工具可通过此 MCP 服务器使用：

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

许可证

MIT

故障排除

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

  docker ps -a | grep mcp-file-server
  

• 查看服务器日志：

  docker logs mcp-file-server
  

• 确保卷已正确挂载：

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