MCP 服务器 Ruby 示例

本仓库包含一系列用 Ruby 编写的 MCP (机器控制协议) 服务器实现和实用工具。它更像是一个 MCP 服务器的实验场所。

可用工具

操作系统实用工具

• 文件系统操作 - 处理文件系统操作，包括：

  • 读取文件
  • 列出目录内容
  • 目录树遍历
  • 文件创建和修改
  • 文件删除
  • 应用补丁

• 剪贴板操作 - 管理系统剪贴板交互

安装

本仓库提供了一个基于 Thor 的安装脚本，用于设置具有不同 Claude 环境的 MCP 服务器。

前提条件

bundle install

媒体服务器需要额外的依赖项：

• ffmpeg (用于音频转码)
• Whisper (用于语音转录)
• Ruby >= 3.0
• fast-mcp gem (1.1.0 或更高版本)

安装 MCP 服务器

mcp_install 脚本提供了用于为不同 Claude 环境安装 MCP 服务器的命令：

# 用于 Claude Desktop
./mcp_install claude_desktop SERVER_PATH [BASE_PATH]

# 用于 Claude Code
./mcp_install claude_code SERVER_PATH [BASE_PATH]

# 用于 Windsurf
./mcp_install windsurf SERVER_PATH [BASE_PATH]

参数：

• SERVER_PATH: MCP 服务器实现的路径
• BASE_PATH: 服务器的基本目录（默认为当前目录）

提示模板

媒体服务器使用位于 media/prompts/ 中的基于 XML 的提示模板：

• summarize.transcript.xml.erb - 用于转录分析
• whats.new.assistant.xml.erb - 用于内容比较（助手）
• whats.new.user.xml.erb - 用于内容比较（用户）

示例：

# 为 Claude Desktop 安装
./mcp_install claude_desktop ./os/clipboard.rb

# 为 Windsurf 安装
./mcp_install windsurf ./os/clipboard.rb

安装程序将：

1. 生成服务器配置
2. 如果找到配置文件，则更新配置文件：
   • Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windsurf: ~/.codeium/windsurf/mcp_config.json
   • Claude Code: (配置路径不同)
3. 如果需要手动安装，则显示生成的配置