MCP Ruby Server Skeleton

基本能力

产品定位

mcp-ruby-skeleton是一个MCP服务器框架，旨在为大型语言模型提供工具调用能力。

核心功能

• get-random-number: 生成1到指定最大值之间的随机整数(默认为100)
• 兼容MCP协议版本2024-11-05
• 详细的调试日志记录
• 符合JSON-RPC 2.0标准的消息处理

适用场景

• 为LLM(如Claude)提供工具调用能力
• 开发自定义MCP工具
• 测试MCP协议实现

工具列表

• get-random-number: 生成随机数的工具

常见问题解答

1. 服务器断开连接
2. 检查协议版本兼容性
3. 检查JSON-RPC消息格式
4. 确保正确的初始化顺序

5. 检查服务器脚本的文件权限

6. 工具未显示

7. 检查服务器是否正确注册在配置文件中
8. 确保服务器脚本有执行权限
9. 完全重启Claude Desktop
10. 检查日志中的错误信息

使用教程

使用依赖

• Ruby 3.0+

安装教程

1. 克隆仓库:

git clone <repository-url>
cd mcp-ruby-skeleton

1. 确保服务器脚本可执行:

chmod +x bin/run_server.rb

运行方式

1. 直接运行服务器:

./bin/run_server.rb

1. 与Claude Desktop集成: 在Claude Desktop配置文件中添加:

{
  "mcpServers": {
    "random-number": {
      "command": "ruby",
      "args": [
        "/path/to/run_server.rb"
      ]
    }
  }
}

调试方式

1. 查看日志:

# macOS
tail -f ~/Library/Logs/Claude/mcp*.log

# Windows
type "%APPDATA%\Claude\logs\mcp*.log"

许可证

None