MCP Server Demo | MCP 伺服器展示

基本能力

产品定位

MCP Server Demo 是一个用于学习和实践 Model Context Protocol (MCP) 的演示项目。

核心功能

• 实现 MCP 协议的基本功能
• 提供与 Claude 的集成能力
• 支持通过 MCP Inspector 进行测试
• 支持通过 STDIO 进行直接测试

适用场景

• MCP 协议的学习和研究
• MCP 服务器的开发实践
• 与 Claude 等工具的集成测试

工具列表

1. MCP Inspector：用于测试和调试 MCP 服务器的工具
2. 能力：可以运行 MCP 服务器并发送测试指令
3. 直接 STDIO 测试：通过标准输入输出与 MCP 服务器交互
4. 能力：可以发送 JSON-RPC 指令并接收响应

常见问题解答

1. 如何与 Claude 集成？
2. 修改 Claude 的配置文件，添加 MCP 服务器的路径信息
3. 如何测试 MCP 服务器？
4. 可以使用 MCP Inspector 或直接 STDIO 测试

使用教程

使用依赖

1. 安装 Ruby
2. 安装 Node.js 和 npm（用于 MCP inspector）

安装教程

1. 克隆或下载项目到本地
2. 配置 Claude 的配置文件，添加以下 JSON 结构：

{
  "mcpServers": {
    "mcp_server_demo": {
      "command": "ruby",
      "args": [
        "<path_to_repository>/demo.rb"
      ]
    }
  }
}

1. 重启 Claude 以应用配置

调试方式

使用 MCP Inspector

1. 安装 MCP inspector：

npm install -g @modelcontextprotocol/inspector

1. 运行服务器：

npx @modelcontextprotocol/inspector ruby demo.rb

直接 STDIO 测试

1. 初始化服务器：

echo '{"jsonrpc":"2.0","id":0,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{"sampling":{},"roots":{"listChanged":true}},"clientInfo":{"name":"mcp-inspector","version":"0.0.1"}}}' | ruby demo.rb

1. 列出可用工具：

echo '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}' | ruby demo.rb

1. 调用工具：

echo '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"_meta":{"progressToken":0},"name":"calculate_sum","arguments":{"a":1,"b":2}}}' | ruby demo.rb

许可证

该项目遵循 MIT 开源许可条款。