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 工具及其響應。你可以通過此界面測試和交互工具。

圖片

以下是項目結構和功能的簡要示意圖：

📄 許可證

文檔中未提及許可證相關信息。

問題或反饋？

隨時打開問題或開始討論！