MCP File Server

MCP File Server

site icon
2025.04.12 0
Python文件系统访问AI助手集成文件管理
MCP File Server 是一个用于读写本地文件系统的 MCP 服务器。该服务器可以与 Claude for Desktop 或其他 MCP 客户端一起使用,为 AI 助手提供文件系统访问功能。
View on GitHub

Overview

基本能力

产品定位

MCP File Server 是一个文件管理系统,旨在为 AI 助手提供本地文件系统的读写能力。

核心功能

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

适用场景

  • 需要 AI 助手访问本地文件系统的场景
  • 自动化文件管理任务
  • 与 Claude for Desktop 集成

工具列表

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

常见问题解答

  • 如果 Claude for Desktop 无法连接到服务器,检查 Docker 容器状态
  • 查看服务器日志以获取更多信息
  • 确保卷已正确挂载

使用教程

使用依赖

  • Docker 已安装在系统上
  • Git(可选,用于克隆存储库)

安装教程

选项1:使用 Docker Compose(推荐)

  1. 克隆存储库: bash git clone https://github.com/abhishekloiwal/mcp-file-server.git cd mcp-file-server

  2. 编辑 docker-compose.yml 文件以更新卷挂载路径(如果需要)。

  3. 使用 Docker Compose 部署: bash docker-compose up -d

选项2:直接使用 Docker

  1. 克隆存储库: bash git clone https://github.com/abhishekloiwal/mcp-file-server.git cd mcp-file-server

  2. 构建 Docker 镜像: bash docker build -t mcp-file-server .

  3. 运行容器并挂载本地目录: bash docker run -d --name mcp-file-server -v /path/to/your/directory:/data mcp-file-server

调试方式

  • 检查 Docker 容器状态: bash docker ps -a | grep mcp-file-server

  • 查看服务器日志: bash docker logs mcp-file-server

  • 检查卷挂载情况: bash docker inspect mcp-file-server | grep -A 10 Mounts

许可证

该项目遵循 MIT 开源许可条款。