文件服务器

MCP文件服务器提供本地文件系统的读写功能,可与Claude for Desktop或其他MCP客户端集成,为AI助手提供文件系统访问能力。

  • by navono
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 navono/mcp-file-server

使用说明

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配置文件:

    • 雨衣: ~/Library/Application Support/Claude/claude_desktop_config.json
    • 窗户: %AppData%\Claude\claude_desktop_config.json
  2. 将mcp文件服务器添加到您的配置中:

    {
      "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:删除文件或目录

其他AI工具集成

LM 工作室

Win11与WSL2:

{
  "mcpServers": {
    "file-server": {
      "command": "wsl docker exec -i mcp-file-server python server.py"
    }
  }
}

许可证

麻省理工学院

故障排除

  • 如果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