Filesystem MCP Server

Filesystem MCP 服务

使用 vector_mcp gem 实现、用于文件系统操作的 Ruby 版 Model Context Protocol（MCP）服务。

功能

• 文件操作：读取、写入、编辑、移动
• 目录操作：创建、列出
• 支持筛选和排序的高级搜索
• 批量元数据操作
• 可选的身份验证和授权
• 使用 MCP roots 限定安全的文件系统边界

安装

1. 安装 Ruby 3.1+ 和 bundler
2. 克隆此仓库
3. 运行 bundle install

用法

基本模式

ruby file_system_mcp.rb ~/Documents ~/Desktop

安全模式（带身份验证）

FILESYSTEM_MCP_API_KEY=your-secret-key ruby file_system_mcp.rb --enable-auth ~/Documents

Claude Desktop 配置

在 claude_desktop_config.json 中添加：

{
  "mcpServers": {
    "filesystem": {
      "command": "ruby",
      "args": [
        "/path/to/file_system_mcp.rb",
        "~/Documents",
        "~/Desktop"
      ]
    }
  }
}

安全模式配置：

{
  "mcpServers": {
    "filesystem": {
      "command": "ruby",
      "args": [
        "/path/to/file_system_mcp.rb",
        "--enable-auth",
        "~/Documents"
      ],
      "env": {
        "FILESYSTEM_MCP_API_KEY": "your-secret-key"
      }
    }
  }
}

工具

文件操作

• read_file - 读取完整文件内容
• read_multiple_files - 一次读取多个文件
• write_file - 创建或覆盖文件
• edit_file - 进行精确的文本替换，并预览差异
• move_file - 移动或重命名文件和目录

目录操作

• list_directory - 列出内容，可选包含元数据
• create_directory - 递归创建目录

搜索操作

• search_files - 使用模式进行基本递归搜索
• find_files - 支持排序、筛选和元数据的高级搜索

信息操作

• get_file_info - 获取文件或目录的详细元数据
• get_bulk_file_info - 高效获取多个文件的元数据

安全性

服务使用 MCP roots 限定文件系统边界，只能访问作为命令行参数指定的目录。

可选的身份验证会为所有操作添加 API 密钥验证。

要求

• Ruby 3.1+
• vector_mcp gem v0.3.1+