AI导哈

文件系统MCP服务

一个基于Ruby的文件系统操作服务，通过Model Context Protocol (MCP)实现文件读写、目录管理、高级搜索等功能，支持安全边界和可选认证。

  • by sergiobayona
  • Ruby
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 sergiobayona/file_system_mcp

使用说明

文件系统MCP服务器

Ruby服务器使用模型上下文协议（MCP）实现文件系统操作 vector_mcp 宝石。

特性

  • 文件操作：读取、写入、编辑、移动
  • 目录操作：创建、列表
  • 具有过滤和排序功能的高级搜索
  • 批量元数据操作
  • 可选的身份验证和授权
  • 使用MCP根保护文件系统边界

安装

  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桌面配置

添加到您的 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 -读取完整文件内容
  • 读取多个文件 -一次读取多个文件
  • write_file -创建/覆盖文件
  • edit_file -使用差异预览进行精确的文本替换
  • move_file -移动/重命名文件和目录

目录操作

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

搜索操作

  • 搜索文件 -带模式的基本递归搜索
  • 查找文件 -具有排序、过滤和元数据的高级搜索

信息操作

  • 获取_文件_信息 -获取详细的文件/目录元数据
  • get_bulk_file_info -高效获取多个文件的元数据

安全

服务器使用MCP根强制文件系统边界-它只能访问指定为命令行参数的目录。

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

需求

  • Ruby 3.1+
  • vector_mcp gem v0.3.1+

相关 MCP