MCP Servers Ruby Examples

MCP サーバーの Ruby の例

このリポジトリには、Ruby で記述された MCP（Machine Control Protocol）サーバーの実装とユーティリティが集められています。MCP サーバーの実験の場として利用されています。

利用可能なツール

オペレーティングシステムのユーティリティ

• ファイルシステム操作 - 次のようなファイルシステム操作を行います：

  • ファイルの読み取り
  • ディレクトリ内容の一覧表示
  • ディレクトリツリーの走査
  • ファイルの作成と変更
  • ファイルの削除
  • パッチの適用

• クリップボード操作 - システムクリップボードとのやり取りを管理します

インストール

このリポジトリには、さまざまな Claude 環境に MCP サーバーをセットアップするための、Thor ベースのインストーラースクリプトが用意されています。

前提条件

bundle install

メディアサーバーには、追加の依存関係が必要です：

• ffmpeg（音声のトランスコード用）
• Whisper（音声の文字起こし用）
• Ruby >= 3.0
• fast-mcp gem（1.1.0 以降）

MCP サーバーのインストール

mcp_install スクリプトには、さまざまな Claude 環境向けに MCP サーバーをインストールするコマンドが用意されています：

# For Claude Desktop
./mcp_install claude_desktop SERVER_PATH [BASE_PATH]

# For Claude Code
./mcp_install claude_code SERVER_PATH [BASE_PATH]

# For 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 - コンテンツの比較用（ユーザー）

例：

# Install for Claude Desktop
./mcp_install claude_desktop ./os/clipboard.rb

# Install for 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. 必要に応じて、手動インストール用に生成した設定を表示します