文件系统 MCP 服务器

一个安全的模型上下文协议 (MCP) 服务器，提供文件系统操作，并对指定目录进行受控访问。

特性

• 通过环境变量控制目录访问
• 仅允许在允许的目录中进行文件操作
• 允许目录的线程安全缓存
• 正确处理带有空格的路径

安装

go get github.com/gomcpgo/filesys

配置

使用环境变量设置允许的目录：

export MCP_ALLOWED_DIRS="/path1,/path2,/path with spaces/dir3"

工具

文件读取

• read_file: 读取单个文件内容
• read_multiple_files: 同时读取多个文件

文件写入

• write_file: 创建或覆盖文件

目录操作

• create_directory: 创建新目录
• list_directory: 列出目录内容
• list_allowed_directories: 显示可访问的目录

文件管理

• move_file: 移动或重命名文件和目录
• get_file_info: 获取文件元数据
• search_files: 使用模式匹配递归搜索文件

与 Claude Desktop 一起使用

添加到 claude_desktop_config.json:

{
  "mcpServers": {
    "filesystem": {
      "command": "/path/to/filesys",
      "env": {
        "MCP_ALLOWED_DIRS": "/path1,/path2,/path with spaces/dir3"
      }
    }
  }
}

工具示例

读取文件

{
    "name": "read_file",
    "arguments": {
        "path": "/allowed/path/file.txt"
    }
}

列出目录

{
    "name": "list_directory",
    "arguments": {
        "path": "/allowed/path"
    }
}

安全性

• 所有操作都限制在允许的目录中
• 防止路径遍历
• 操作前进行权限验证
• 正确的错误处理和日志记录

构建

go build -o bin/filesys cmd/main.go

许可证

MIT 许可证

贡献

欢迎提交 Pull Request。请确保：

• 测试通过
• 新功能包含文档
• 代码遵循项目风格