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 感兴趣）感兴趣，我们非常欢迎你的参与！在仓库中提出问题，或通过 邮件联系 进行交流！

如果你尝试使用此框架进行项目开发：感谢你的试用！我非常乐意听到你的体验！