mcp-servers-ruby

🚀 MCP 服务器 Ruby 示例

此仓库包含一系列基于机器控制协议（MCP）的服务器实现与实用工具，主要采用 Ruby 语言编写。这里更像是一个实验场，用于探索 MCP 服务器的各种可能性。

🚀 快速开始

本项目提供了丰富的 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：服务器的基础目录（默认为当前目录）

提示模板

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

• 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. 显示生成的配置，以便需要时手动安装