MCP Rails Template

🚀 行動 MCP 示例

這是一個簡單的 Ruby on Rails 應用程序，用於展示如何集成和使用 ActionMCP gem。該 gem 的源代碼可在 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）獲取 gems。資源 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 gem 的 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 都能為你的開發流程增添巨大價值。