Rig MCP Server

🚀 🔍 使用 Rust 的 MCP 服务器 + 检查工具示例：带有加法工具的 SSE 运输

本项目展示了如何借助 Server-Sent Events（SSE）进行通信，来搭建一个 MCP（模型上下文协议）服务器和客户端。项目中包含一个简单的加法工具，并且与 RIG 代理集成，可用于大语言模型（LLM）提示。

🚀 快速开始

克隆此仓库并运行：

cargo run

在另一个终端启动 MCP 检查工具：

npx @modelcontextprotocol/inspector sse http://127.0.0.1:3001/sse

你会看到类似以下输出：

正在启动 MCP 检查工具...
代理服务器侦听于端口 3000
新 SSE 连接
查询参数：{ transportType: 'sse', url: 'http://localhost:3001/sse' }
SSE 运输：url=http://localhost:3001/sse，headers=
连接到 SSE 运输
将 MCP 客户端连接到后端服务器运输
创建 web 应用运输
设置 MCP 代理
🔍 MCP 检查工具已启动并运行在 http://localhost:5173 🚀

你可以在 http://localhost:5173 查看网络界面。

✨ 主要特性

• ✅ 设置使用 ServerSseTransport 的自定义 MCP 服务器
• ✅ 将 MCP 客户端连接到服务器
• ✅ 注册一个自定义工具：AddTool，用于加法运算
• ✅ 列出注册的工具
• ✅ 与 RIG 集成，并使用工具提示 LLM 代理

💻 使用示例

基础用法

此代码定义了 Add 工具，该工具在 MCP 服务器中注册。

#[tool(
    name = "Add",
    description = "Adds two numbers together.",
    params(a = "The first number to add", b = "The second number to add")
)]
async fn add_tool(a: f64, b: f64) -> Result<ToolResponseContent> {
    Ok(tool_text_content!((a + b).to_string()))
}

高级用法

主函数设置：

• 跟踪
• MCP 服务器和运输（SSE）
• 连接到 MCP 客户端并列出可用工具
• 带有 OpenAI 后端的 RIG 代理，使用 MCP 工具

然后代理运行提示：

let response = agent.prompt("Add 10 + 10").await;

🧪 示例输出

成功运行时，你会看到类似以下日志：

初始化完成：Ok(...)
工具：Ok([...])
构建 RIG 代理
提示 RIG 代理
代理响应：Some("20")

🔧 技术细节

技术栈

依赖项

项目需要以下依赖项：

[dependencies]
mcp = "0.1"
tokio = { version = "1.0", features = ["full"] }

这些可以在 Cargo.toml 文件中找到。

📚 详细文档

检查工具界面

启动检查工具后，你将访问一个网络界面，其中显示注册的 MCP 工具及其响应。你可以通过此界面测试和交互工具。

图片

以下是项目结构和功能的简要示意图：

📄 许可证

文档中未提及许可证相关信息。

问题或反馈？

随时打开问题或开始讨论！