🚀 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。