mcp-file-server-l3w

🚀 MCP 文件服务器

MCP 文件服务器可从本地文件系统读取和写入文件，适用于Claude Desktop或其他MCP客户端，能为AI助手提供文件系统访问能力，助力高效文件操作。

✨ 主要特性

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

📦 安装指南

选项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