Poemcp

🚀 MCP 服務器與綜合工具

本項目基於 Model Context Protocol (MCP) 實現了一個 Rust 服務器，藉助 poem 框架搭建而成。此服務器提供了一系列實用工具，可用於管理計數器、執行數字加法運算、驗證 IP 地址，以及檢查 IP 是否處於 CIDR 範圍內。這些工具通過即時的 Server-Sent Events (SSE) 端點向客戶端開放。

✨ 主要特性

• 計數器：支持對計數器進行增加、減少操作，並能獲取當前計數器的值。
• 加法器：可實現兩個整數的相加運算。
• IP 驗證器：能夠驗證字符串是否為有效的 IPv4 地址。
• 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：用於實現 MCP 服務器的庫，帶有工具和 SSE 端點。
• tokio：Rust 的異步運行時。

💻 使用示例

基礎用法

服務器運行後，可以通過 SSE 客戶端連接到 /sse 端點。以下是一個使用 JavaScript 瀏覽器的示例：

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

eventSource.onmessage = function(event) {
    console.log('接收到數據:', event.data);
};

📄 許可證

該項目採用 MIT 許可證。有關詳細信息，請參閱 LICENSE 文件。