文件系统 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 (字符串)
  • 返回:
    • 大小
    • 创建时间
    • 修改时间
    • 访问时间
    • 类型（文件/目录）
    • 权限

• 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 许可证下获得许可。 这意味着您可以自由使用、修改和分发该软件，但须遵守 MIT 许可证的条款和条件。 有关更多详细信息，请参阅项目存储库中的 LICENSE 文件。