Ruby MCP 示例

它需要 Ruby 3.3 或更高版本。

一个使用 mcp-rb gem 的简单 Ruby MCP（模型上下文协议）服务器实现。

安装

1. 确保你已经安装了 Ruby
2. 安装所需的宝石：

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