MCP Ruby Skeleton

🚀 MCP Ruby サーバースケルトン

このプロジェクトは、大型言語モデル（LLMs）である Claude などがツールを呼び出せるようにするインターフェースを提供する、Model Context Protocol (MCP) サーバーの Ruby 実装です。現在の実装では、乱数を生成するツールが提供されています。

謝辞：本実装のアイデアは、Azuki Azusa の記事 Building a Model Context Protocol Server with TypeScript から得られました。

✨ 主な機能

• get-random-number：指定された最大値（デフォルトは 100）までの乱数を生成します。
• MCP プロトコルバージョン 2024 - 11 - 05 と互換性があります。
• デバッグ用の詳細なログ記録が行われます。
• JSON - RPC 2.0 に準拠したメッセージ処理を行います。

📦 インストール

Git を使用したリポジトリのクローン

git clone [your-repository-url]
cd mcp-ruby-server

依存関係の管理

このプロジェクトでは、Bundler を使用して依存関係を管理しています。

bundle install

💻 使用例

サーバーの起動

ruby server.rb

デフォルトでは、サーバーは localhost:3000 を監視します。

ツールの呼び出し

get-random-number ツールの呼び出し

curl -X POST http://localhost:3000 -d '{"method":"get-random-number","params":{},"id":1}'

応答例：

{
  "result": 42,
  "id": 1
}

📚 ドキュメント

要件

• Ruby 3.0 以上

アーキテクチャと設計

このサーバーは以下のコンポーネントで構成されています。

コアコンポーネント

• MCP::Server：MCP プロトコルメッセージの処理を担当する主要なサーバー実装です。

  • プロトコルの初期化
  • ツールの登録と管理
  • メッセージの処理
  • ツールの一覧表示と実行
  • エラー処理

• MCP::Transport::Stdio：通信に使用される標準 I/O トランスポート層です。

  • メッセージの受信
  • 応答の送信
  • イベント駆動型のメッセージ処理

• MCP::Tool：ツールの定義と実行を担当するハンドラーです。

  • ツールの名前、説明、入力モードの管理
  • ツールのロジック実装
  • 実行中のパラメータ処理

• RandomNumberServer：乱数の生成とツールの登録を担当するサーバー実装です。

アーキテクチャと設計の説明

サーバーの全体的なアーキテクチャは、モジュール化設計の原則に従っています。MCP::Server はコアコンポーネントで、すべてのツールの登録と管理、およびクライアントからのリクエストの処理を担当します。MCP::Transport::Stdio は標準 I/O トランスポート層で、メッセージの送受信を担当します。MCP::Tool は具体的なツールの実装クラスで、各ツールには独自のロジックとパラメータ検証があります。

デバッグ

ログ記録

サーバーは詳細なログ記録機能を提供しており、ログ情報には以下が含まれます。

• リクエスト内容
• 応答内容
• エラー情報（ある場合） ログファイルは log/server.log に保存されます。

よくある質問

1. 大きな入力を処理するにはどうすればいいですか？

rand メソッドの最大値を調整します。

max = (args["max"] || 100).to_i
max = [max, 100].min # 最大値が 100 を超えないようにする

開発

新しいツールの追加

RandomNumberServer の initialize メソッドに新しいツールを追加します。

def initialize(server)
  super

  # 新しいツールの登録
  new_tool = MCP::Tool.new(
    "new-tool-name",
    "新しいツールの説明",
    {
      type: "object",
      properties: {
        # ツールのパラメータ
      }
    }
  ) do |args|
    # ツールの実装
  end

  server.register_tool(new_tool)
end

テスト

新しいツールやサーバー機能を追加する際には、テストを追加することをおすすめします。テストには以下が含まれるべきです。

• 単体テスト：ツールの定義と登録の正しさを検証します。
• 統合テスト：プロトコル処理の正しさを検証します。
• エンドツーエンドテスト：クライアントとサーバーのやり取りの正しさを検証します。

エラー処理と例外処理

MCP サーバーの堅牢性を向上させるために、以下のエラー処理を実装することをおすすめします。

1. ツールの実行中に例外をキャッチし、クライアントに意味のあるエラーメッセージを返します。
2. 無効な入力パラメータを検証します。
3. ネットワークと I/O エラーを適切に処理します。
4. タイムアウトとリソース制限を考慮します。