文件系统 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 License

项目贡献

欢迎提交拉取请求。请确保：

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