Kuri

🚀 Kuri（栗或 くり）

kuri 是一個用於構建 Model Context Protocol (MCP) 服務器的框架，它著重提升開發者體驗，讓代碼更加清晰易懂。藉助這個框架，開發者能夠更高效地構建出滿足需求的 MCP 服務器。

MCP 允許大型語言模型（LLM）執行預定義函數（稱為“工具”），這些函數可用於獲取數據並進行副作用操作（即與外部世界交互）。LLM 只需提供函數的輸入參數，函數即可被執行，結果也會返回給模型。這些工具由“MCP 服務器”提供，可在本地運行，且一個服務器能提供多個工具。

✨ 主要特性

• 基於 Rust 開發：Rust 強大的類型系統和正確性保證，讓 kuri 構建的 MCP 服務器更加可靠。
• 開發者友好：MCP 服務器編程像普通 Rust 編程一樣直觀，減少了開發者的學習成本。
• 最小化宏使用：僅用 (#[tool], #[prompt]) 附加工具和參數描述，避免複雜代碼生成。
• 減少樣板代碼：使開發者專注於應用程序邏輯，而非序列化或 MCP 協議路由。
• 利用 tower 生態系統：提供傳輸、服務和中間件的支持。

🚀 快速開始

MCP 允許大型語言模型（LLM）執行預定義函數（稱為“工具”），這些函數可以用於獲取數據並進行副作用操作（即與外部世界交互）。LLM 只需提供函數的輸入參數，然後函數被執行，並將結果返回給模型。這些工具由“MCP 服務器”提供，可以在本地運行，且一個服務器可以提供多個工具。

🔧 技術細節

設計理念

Rust 是編寫可靠 MCP 服務器的理想語言，其強大的類型系統和正確性保證使其成為上佳選擇。kuri 的目標是讓 Rust 編寫 MCP 服務器變得極為愉快，以便促進使用 Rust 構建 MCP 服務器。我們的設計目標包括：

• 開發者友好體驗：MCP 服務器編程應該像普通的 Rust 編程一樣直觀。
• 最小化宏的使用 (#[tool], #[prompt])：僅用於附加工具和參數描述，而不是複雜的代碼生成。
• 減少樣板代碼：專注於應用程序邏輯，而非序列化或 MCP 協議路由。
• 利用 tower 生態系統，提供傳輸、服務和中間件的支持。

MCP 核心功能進度

• 核心生命週期：連接初始化、能力協商和會話控制已完成。
• 工具：功能完善且經過測試。
• 提示：大部分完成並經過測試。
• 資源：待完成。
• 傳輸：
  • 標準輸入/輸出 (StdioTransport) 已完成。
  • 流式 HTTP（2025-03-26 協議）待完成。
• 可選功能：
  • 自動完成 待完成。
  • 分頁 待完成。

當前的優先事項是添加 HTTP 傳輸支持、穩定 API 並確保完全符合核心規範。

🤝 貢獻

該項目的目標是構建一個愉快、友好、符合 Rust 風格的 MCP 服務器庫。目前仍處於早期階段，結構仍有調整空間。如果你對 Rust、MCP、構建 crate 或網絡協議（可能你對 protohackers 感興趣）感興趣，我們非常歡迎你的參與！在倉庫中提出問題，或通過 郵件聯繫 進行交流！

如果你嘗試使用此框架進行項目開發：感謝你的試用！我非常樂意聽到你的體驗！