Ap MCP

🚀 Ruby MCP 示例

本示例項目是一個使用 mcp-rb gem 的簡單 Ruby MCP（模型上下文協議）服務器實現，它需要 Ruby 3.3 或更高版本。

🚀 快速開始

本項目需要 Ruby 3.3 或更高版本。以下是快速開始的步驟：

📦 安裝指南

1. 確保你已經安裝了 Ruby。
2. 安裝所需的寶石，你可以選擇以下兩種方式之一：
   • 使用 gem 命令直接安裝：

gem install mcp-rb

- 使用 `Gemfile` 安裝：

bundle install

💻 使用示例

運行服務器

直接運行

你可以直接運行 MCP 服務器：

ruby ruby_mcp_app.rb

作為持久服務運行

為了使 MCP 服務器對 Cursor 和其他客戶端可用，它需要保持運行，你有以下三種選擇：

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 配置中。
• 寶石安裝正確。
• 工具參數類型（例如，Float vs Integer）。
• 服務器運行狀態：確保 MCP 服務器實際上正在運行。
• 檢查調試日誌文件 /Users/steveodom/Documents/Projects/mcp-ruby/mcp_app.log。