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. 顯示生成的配置，以便需要時手動安裝