MCP Rails Template

🚀 アクション MCP サンプル

このアプリケーションは、シンプルな Ruby on Rails アプリケーションで、ActionMCP ジェムの統合と使用方法を示しています。このジェムのソースコードは GitHub で確認できます：https://github.com/seuros/action_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

これにより、ポート 5466 で PostgreSQL が起動します。 または、config/database.yml を編集して、独自の PostgreSQL データベースを設定することもできます。

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

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

bin/rails s

アプリケーションは http://localhost:3002 でアクセスできます。

🔧 ActionMCP エンジン

ActionMCP エンジンは /action_mcp にマウントされています。ルートを変更することで、任意の場所にマウントできます。

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

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

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

• epic_adventure_prompt.rb：提供されたヒーロー名と冒険のタイプ（ファンタジー、サイエンスフィクション、サスペンス）に基づいて、短い叙述的な冒険物語を生成します。オプションで、プレースホルダー画像データ文字列を含めることができます。

リソーステンプレート（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：Bundler を使用して、Gemfile と Gemfile.lock から依存関係情報を取得します。また、.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 ジェムの API を使用して、提供された Ruby コードを分析します。検出されたすべてのスタイルまたはコード品質の違反を報告し、ルール名、メッセージ、行番号、および列番号を含みます。
• ruby_code_analyzer_tool.rb：プロジェクトディレクトリ内の Ruby コードに対して基本的な静的分析を実行します。.rb ファイルを解析して、クラス、モジュール、およびメソッドをインデックス化します。見つかったすべてのクラス、モジュール、またはメソッドを一覧表示するか、特定のクラス/モジュール（constant）またはメソッド（method_details）の詳細を取得できます。

🛠️ 使用方法

MCP 機能を対話的にテストし、確認するには、MCP インスペクターを使用できます：

npx @modelcontextprotocol/inspector --url http://localhost:3002/action_mcp

インスペクターコマンドを実行する前に、Rails サーバー（bin/rails s）が実行されていることを確認してください。

🤝 コントリビューション

コントリビューションを歓迎します！このプロジェクトを改善するために、GitHub で問題またはプルリクエストを送信してください。

このプロジェクトは、ActionMCP を使用して Ruby on Rails で強力なコンポーネント化と拡張性を実現する方法を示しています。プロンプト生成、依存関係管理、コード分析など、ActionMCP は開発プロセスに大きな価値をもたらします。