文件系统 MCP 服务器

用 Go 语言实现的模型上下文协议（MCP）文件系统操作服务器。

特性

• 读取/写入文件
• 创建/列出/删除目录
• 移动文件/目录
• 搜索文件
• 获取文件元数据
• 生成目录树结构

注意：该服务器仅允许在 args 中指定的目录内执行操作。

API

资源

• file://system：文件系统操作接口

工具

• read_file

  • 读取文件的全部内容
  • 输入：path（字符串）
  • 使用 UTF-8 编码读取完整的文件内容

• read_multiple_files

  • 同时读取多个文件
  • 输入：paths（字符串数组）
  • 失败的读取不会停止整个操作

• write_file

  • 创建新文件或覆盖现有文件（谨慎使用此功能）
  • 输入：
    • path（字符串）：文件路径
    • content（字符串）：文件内容

• create_directory

  • 创建新目录或确保其存在
  • 输入：path（字符串）
  • 如果需要，创建父目录
  • 如果目录已存在，则会静默成功

• list_directory

  • 列出目录内容，带有 [FILE] 或 [DIR] 前缀
  • 输入：path（字符串）

• move_file

  • 移动或重命名文件和目录
  • 输入：
    • source（字符串）
    • destination（字符串）
  • 如果目标已存在，则会失败

• search_files

  • 递归搜索文件/目录
  • 输入：
    • path（字符串）：起始目录
    • pattern（字符串）：搜索模式
  • 不区分大小写的匹配
  • 返回完整路径的匹配项

• get_file_info

  • 获取文件/目录的详细元数据
  • 输入：path（字符串）
  • 返回：
    • 大小
    • 创建时间
    • 修改时间
    • 访问时间
    • 类型（文件/目录）
    • 权限

• tree

  • 返回目录结构的层次化 JSON 表示
  • 输入：
    • path（字符串）：要遍历的目录（必需）
    • depth（数字）：要遍历的最大深度（默认值：3）
    • follow_symlinks（布尔值）：是否要跟随符号链接（默认值：false）
  • 返回格式化的 JSON，显示文件/目录层次结构
  • 包含文件元数据（名称、路径、大小、修改时间）

• list_allowed_directories

  • 列出服务器可以访问的所有目录
  • 不需要输入
  • 返回：
    • 该服务器可以读取和写入的目录

使用 Claude Desktop

安装服务器

go install github.com/mark3labs/mcp-filesystem-server

在 claude_desktop_config.json 中添加以下内容：

{
  "mcpServers": {
    "filesystem": {
      "command": "mcp-filesystem-server",
      "args": [
        "/Users/username/Desktop",
        "/path/to/other/allowed/dir"
      ]
    }
  }
}

许可证

此 MCP 服务器根据 MIT License 分发。这意味着您可以自由地使用、修改和分发软件，但需遵守 MIT License 的条款和条件。有关更多详细信息，请参阅项目存储库中的 LICENSE 文件。