MCP 文件服务器

一个用于从本地文件系统读取和写入文件的MCP服务器。此服务器可用于Claude 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 Desktop

1. 创建或更新Claude Desktop配置文件，位置如下：

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

2. 在配置文件中添加MCP服务器的配置：

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

3. 重启Claude Desktop。

4. 现在，您应该能够看到文件服务器工具已可用。

可用工具

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

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

许可证

MIT

故障排除

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

  docker ps -a | grep mcp-file-server
  

• 查看服务器日志：

  docker logs mcp-file-server
  

• 确保卷已正确挂载：

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