Action MCP Example 🚀

Action MCP のサンプル 🚀

ActionMCP gem の統合方法と使用方法を紹介するシンプルな Ruby on Rails アプリケーションです。gem のソースコードは GitHub の https://github.com/seuros/mcp で確認できます。

このアプリケーションでは、Rails プロジェクト内で MCP コンポーネントを定義して使用する方法を紹介します。

---

要件

• Ruby（推奨バージョンは .ruby-version を参照）
• PostgreSQL（または Docker）

---

はじめに

1. クローンとセットアップ

git clone https://github.com/seuros/mcp_rails_template.git
cd mcp_rails_template
bin/setup

2. 環境設定

用意されている .env.example ファイルをコピーします。

cp .env.example .env

.env を編集し、環境に応じて必要な値を入力します（特に、fetch_weather_by_location_tool などのツールに必要な API キーを入力してください）。

3. データベースのセットアップ

Docker を使用して、一時的な PostgreSQL インスタンスをすぐに起動できます。

make up

これにより、PostgreSQL がポート 5466 で起動します。

または、config/database.yml を編集して独自の PostgreSQL データベースを設定してください。

4. アプリケーションの実行

Rails サーバーを起動します。

bin/rails s

アプリは http://localhost:3002 で利用できます。

---

ActionMCP サーバー

ActionMCP は、mcp.ru を介してポート 62770 でスタンドアロンサーバーとして実行されます。Nginx は /mcp リクエストをこのサーバーにプロキシします。

Client → nginx:8080/mcp → ActionMCP:62770

---

認証

このアプリケーションでは、ApplicationGateway クラスを介した JWT ベースの認証を使用します。

テストユーザー（フィクスチャから）

メールアドレス	パスワード	ロール
[email protected]	password123	テストユーザー
[email protected]	password123	管理者ユーザー

フィクスチャの読み込み

bin/rails db:fixtures:load FIXTURES=users

JWT トークンの生成

# In Rails console
user = User.find_by(email: '[email protected]')
token = user.generate_jwt(expires_in: 10.years)  # Long-lived for demo

MCP クライアントの設定

事前に設定された長期間有効なトークンを含む .mcp.json ファイルが用意されています。

{
  "mcpServers": {
    "mcp_rails_template": {
      "url": "http://localhost:8080/mcp",
      "headers": {
        "Authorization": "Bearer <token>"
      }
    }
  }
}

または、curl で手動でテストします。

curl -H "Authorization: Bearer <token>" http://localhost:8080/mcp

ゲートウェイの設定

ゲートウェイは config/mcp.yml で設定されています。

development:
  authentication: ["jwt"]
  gateway_class: "ApplicationGateway"

ツール内でのユーザーへのアクセス

class MyTool < ApplicationMCPTool
  def perform
    render text: "Hello #{current_user.name}!"
  end
end

---

MCP コンポーネント（app/mcp/）

このアプリケーションには、ActionMCP コンポーネントの例がいくつか含まれています。

プロンプト（app/mcp/prompts/）

• epic_adventure_prompt.rb：指定されたヒーロー名と冒険の種類（ファンタジー、SF、ミステリー）に基づいて、短い物語風の冒険ストーリーを生成します。プレースホルダーの画像データ文字列を任意で含めることもできます。

リソーステンプレート（app/mcp/resource_templates/）

• gemfile_template.rb：プロジェクトの Gemfile の依存関係を JSON リソースとして提供します。Bundler を使用し、指定された環境（production、test、development、または default）に基づいて gem を取得します。リソース URI は gemfile://{environment} の形式です。

ツール（app/mcp/tools/）

ツールは、言語モデルが実行を要求できる具体的なアクションを定義します。

• dependency_info_tool.rb：Gemfile と Gemfile.lock から Bundler を使用して依存関係の情報を取得します。また、実行時の依存関係については .gemspec ファイルも確認します。production、test、runtime の依存関係をそれぞれ別の JSON リソースとして出力します。
• fetch_weather_by_location_tool.rb：指定された緯度と経度の座標に基づいて、Open-Meteo API（https://api.open-meteo.com）から天気予報データを取得します。API からの未加工の JSON レスポンスを返します。
• rubocop_tool.rb：RuboCop gem の API を使用して、指定された Ruby コードスニペットを分析します。検出されたスタイルまたはコード品質に関する違反について、ルール名、メッセージ、行番号、列番号を含めて報告します。
• ruby_code_analyzer_tool.rb：プロジェクトディレクトリ内の Ruby コードに対して、基本的な静的解析を実行します。.rb ファイルを解析して、クラス、モジュール、メソッドをインデックス化します。検出されたすべてのクラス、モジュール、メソッドの一覧表示や、特定のクラス／モジュール（constant）またはメソッド（method_details）の詳細（ソースコードのスニペットを含む）の取得をリクエストできます。

---

使い方

MCP の機能を対話形式でテストおよび確認するには、MCP Inspector を使用できます。

npx @modelcontextprotocol/inspector --url http://localhost:8080/mcp

Inspector コマンドを実行する前に、Docker が実行中であることを確認してください（docker compose up）。

---

コントリビューション

お気軽にご協力ください！このサンプルの改善に役立つイシューの作成やプルリクエストの送信をお待ちしています。

---

楽しいコーディングを！✨🚀