文件系统操作服务器

基于Go语言实现的文件系统操作服务器,支持文件读写、目录管理、文件搜索和元数据获取等功能,适用于需要文件系统集成的开发场景。

  • by ngoiyaeric
  • 本地部署
  • 更新于
在 GitHub 查看 ngoiyaeric/mcp-filesystem-server

使用说明

文件系统MCP服务器

Go服务器实现了用于文件系统操作的模型上下文协议(MCP)。

特性

  • 读/写文件
  • 创建/列出/删除目录
  • 移动文件/目录
  • 搜索文件
  • 获取文件元数据

备注:服务器只允许在通过指定的目录内进行操作 args.

API

资源

  • file://system:文件系统操作界面

工具

  • read_file

    • 读取文件的完整内容
    • 输入: path (字符串)
    • 读取UTF-8编码的完整文件内容
  • 读取多个文件

    • 同时读取多个文件
    • 输入: paths (字符串[])
    • 读取失败不会停止整个操作
  • write_file

    • 创建新文件或覆盖现有文件(请谨慎操作)
    • 输入:
      • path (string):文件位置
      • content (string):文件内容
  • create_directory

    • 创建新目录或确保其存在
    • 输入: path (字符串)
    • 如果需要,创建父目录
    • 如果目录存在,则自动成功
  • list_directory

    • 列出带有[FILE]或[DIR]前缀的目录内容
    • 输入: path (字符串)
  • move_file

    • 移动或重命名文件和目录
    • 输入:
      • source (字符串)
      • destination (字符串)
    • 如果目标存在,则失败
  • 搜索文件

    • 递归搜索文件/目录
    • 输入:
      • path (string):起始目录
      • pattern (string):搜索模式
    • 不区分大小写的匹配
    • 返回匹配项的完整路径
  • 获取_文件_信息

    • 获取详细的文件/目录元数据
    • 输入: 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文件。