Ap MCP

🚀 Ruby MCP サンプル

このプロジェクトは、Ruby 3.3 以上が必要です。 mcp-rb gem を使用した、シンプルな Ruby MCP（モデルコンテキストプロトコル）サーバの実装です。

🚀 クイックスタート

📦 インストール

1. Ruby がインストールされていることを確認してください。
2. 必要な gem をインストールします。

gem install mcp-rb

または、Gemfile を使用する場合は以下のコマンドを実行します。

bundle install

サーバの起動

直接起動

MCP サーバを直接起動することができます。

ruby ruby_mcp_app.rb

永続的なサービスとして起動

Cursor や他のクライアントが MCP サーバを利用できるようにするには、サーバを起動し続ける必要があります。以下の 3 つの方法があります。

1. Cursor による自動起動：Cursor は mcp.json の設定に基づき、必要なときにサーバを自動的に起動します。
2. 別のターミナルウィンドウで手動起動：

# 専用のターミナルウィンドウで
cd /Users/steveodom/Documents/Projects/mcp-ruby
ruby ruby_mcp_app.rb

このターミナルを開いたままにすることで、サーバが継続的に動作します。 3. バックグラウンドプロセスとして起動：

# バックグラウンドで起動
cd /Users/steveodom/Documents/Projects/mcp-ruby
nohup ruby ruby_mcp_app.rb > mcp_server.log 2>&1 &

# プロセス ID を記録
echo $! > mcp_server.pid

# 後で停止する場合
kill $(cat mcp_server.pid)

クライアントでのテスト

MCP サーバとのやり取り方法を示すテストクライアントが含まれています。

ruby test_client.rb

Cursor との統合

サーバは Cursor の MCP 設定ファイルに以下のように設定されています。

{
  "ruby-mcp-demo": {
    "command": "ruby",
    "args": [
      "/Users/steveodom/Documents/Projects/mcp-ruby/ruby_mcp_app.rb",
      "--stdio",
      "--debug"
    ],
    "enabled": true
  }
}

💻 使用例

基本的な使用法

Greet ツール

名前を指定して挨拶をすることができます。

# クライアントコードでの使用例：
result = client.call_tool(
  name: "greet",
  args: {name: "World"}
)
# 返り値：こんにちは、World！Ruby MCP へようこそ。

Calculate ツール

基本的な算術演算を実行することができます。

# 加法
result = client.call_tool(
  name: "calculate",
  args: {operation: "add", a: 5.0, b: 3.0}
)
# 返り値：結果：8.0

# 乗法
result = client.call_tool(
  name: "calculate",
  args: {operation: "multiply", a: 4.0, b: 7.0}
)
# 返り値：結果：28.0

# 除法
result = client.call_tool(
  name: "calculate",
  args: {operation: "divide", a: 10.0, b: 2.0}
)
# 返り値：結果：5.0

# 減法
result = client.call_tool(
  name: "calculate",
  args: {operation: "subtract", a: 10.0, b: 4.0}
)
# 返り値：結果：6.0

高度な使用法

サーバの拡張

新しいツールやリソースを追加するには、ruby_mcp_app.rb ファイルを編集します。

# 新しいツールを追加
tool "new_tool_name" do
  description "ツールの機能を説明"
  argument :param_name, 型, required: true, description: "パラメータの説明"
  call do |args|
    # ツールの実装
  end
end

📚 ドキュメント

デバッグ

問題が発生した場合は、以下の点を確認してください。

• MCP 設定で正しいパスが指定されていること。
• gem が正しくインストールされていること。
• ツールのパラメータの型（例：Float と Integer）が正しいこと。
• サーバの実行状態：MCP サーバが実際に起動していることを確認してください。
• デバッグログファイル /Users/steveodom/Documents/Projects/mcp-ruby/mcp_app.log を確認してください。