poem-mcpserver is an MCP server implementation built for the Poem framework, designed to facilitate seamless interaction between AI models and custom tools. It empowers developers to create tools that AI models can leverage, enhancing their capabilities. By utilizing the Tools macro, defining tools with functionalities like incrementing, decrementing, and retrieving values becomes straightforward. The server communicates via standard input/output (stdio), simplifying integration. This solution addresses the developer pain point of complex tool creation and integration, offering a streamlined approach to building custom functionalities for AI models. The core value lies in its ease of use and the ability to extend AI model capabilities with tailored tools, all while ensuring memory safety through its 100% Safe Rust implementation. It uses the Text type to wrap return values.

基于Poem框架的MCP服务器

poem-mcpserver 提供了在 Poem Web 框架内构建 MCP 服务器的能力，简化了 AI 模型与外部工具的集成过程。它允许开发者利用 Poem 的强大功能（如中间件、路由等）来构建 MCP 服务器，从而实现更灵活、可扩展的 AI 应用。通过将 MCP 服务器构建在成熟的 Web 框架之上，开发者可以更轻松地管理请求、处理认证和授权，并监控服务器的运行状态。例如，开发者可以使用 Poem 的中间件来记录 MCP 请求的日志，或者使用 Poem 的路由功能来将不同的 MCP 工具映射到不同的 URL 路径。这为构建复杂的 AI 应用提供了坚实的基础。

Tools 宏简化工具定义

poem-mcpserver 使用 Tools 宏，极大地简化了 MCP 工具的定义过程。开发者只需在一个结构体上使用 #[Tools] 属性，并为该结构体实现相应的异步方法，即可自动生成 MCP 服务器所需的工具定义。这消除了手动编写大量样板代码的需要，提高了开发效率。例如，在示例代码中，Counter 结构体通过 #[Tools] 宏，自动将其 increment、decrement 和 get_value 方法暴露为 MCP 工具，无需开发者手动创建工具描述文件或编写额外的注册代码。这使得开发者可以专注于工具的业务逻辑，而无需关心底层的 MCP 协议细节。

标准输入/输出通信

poem-mcpserver 通过 stdio 函数支持标准输入/输出 (stdin/stdout) 通信，这是一种简单而通用的通信方式，适用于各种环境。使用 stdio，MCP 客户端和服务器可以通过操作系统的标准输入和输出流进行数据交换，无需建立复杂的网络连接或配置额外的通信协议。例如，开发者可以使用命令行工具或脚本作为 MCP 客户端，通过标准输入向 poem-mcpserver 发送请求，并通过标准输出接收响应。这种方式特别适用于本地开发、调试和集成测试，以及在资源受限的环境中部署 MCP 服务器。

安全的Rust实现

poem-mcpserver 采用 #![forbid(unsafe_code)]，保证所有代码均使用安全的 Rust 实现。这意味着该库不包含任何不安全的代码块，从而避免了潜在的内存安全问题和未定义行为。这对于构建可靠和安全的 AI 应用至关重要，特别是当涉及到处理敏感数据或在生产环境中部署时。通过使用安全的 Rust，poem-mcpserver 提供了更高的安全保障，降低了因代码漏洞而导致的安全风险。