带有组合工具的 MCP 服务器

本项目使用 Rust 语言和 poem 框架实现了一个模型上下文协议 (MCP) 服务器。该服务器提供了多个工具，用于管理计数器、加法运算、验证 IP 地址以及检查 IP 是否在 CIDR 范围内。这些工具通过服务器发送事件 (SSE) 端点暴露，允许客户端实时与服务器交互。

功能特性

• 计数器:

  • 递增、递减以及获取计数器的当前值。

• 加法器:

  • 将两个整数相加。

• IP 验证器:

  • 验证给定的字符串是否为有效的 IPv4 地址。

• CIDR 检查器:

  • 检查 IP 地址是否在指定的 CIDR 范围内。

端点

• /sse: 一个服务器发送事件 (SSE) 端点，实时暴露这些工具。

工具

• 递增: 将计数器递增 1。
• 递减: 将计数器递减 1。
• 获取值: 检索当前的计数器值。
• 加法: 将两个数字相加。
• 是否为有效的 IPv4: 检查字符串是否为有效的 IPv4 地址。
• IP 是否在 CIDR 中: 检查 IP 地址是否在 CIDR 范围内。

设置

要求

• Rust 1.60 或更高版本
• Cargo (Rust 的包管理器和构建系统)

安装

1. 克隆仓库:

   git clone https://github.com/yourusername/mcp-server.git
   cd mcp-server
   

2. 构建项目:

   cargo build --release
   

3. 运行服务器:

   cargo run
   

服务器将启动并监听 http://127.0.0.1:8000。

依赖项

• poem: 一个 Rust 的 Web 框架。
• poem_mcpserver: 一个用于实现带有工具和 SSE 端点的 MCP 服务器的库。
• tokio: Rust 的异步运行时。

使用示例

一旦服务器运行，您可以通过 SSE 客户端连接到 /sse 端点。以下是在浏览器中使用 JavaScript 的示例：

const eventSource = new EventSource('http://127.0.0.1:8000/sse');

eventSource.onmessage = function(event) {
    console.log('Received data:', event.data);
};

许可证

本项目采用 MIT 许可证。 详情请参阅 LICENSE 文件。