Poemcp

🚀 MCP サーバーと総合ツール

このプロジェクトは、Model Context Protocol (MCP) に基づく Rust サーバーを実装しています。poem フレームワークを使用しており、カウンターの管理、数字の加算、IP アドレスの検証、および IP が CIDR 範囲内にあるかどうかのチェックなど、さまざまなツールを提供します。これらのツールは、リアルタイムの Server-Sent Events (SSE) エンドポイントを介してクライアントに公開されます。

🚀 クイックスタート

この MCP サーバーは、Model Context Protocol (MCP) を用いたRustサーバーで、poem フレームワークを使って構築されています。カウンター管理やIPアドレス検証などの多様な機能を提供し、SSEエンドポイントを通じてクライアントに公開されます。

✨ 主な機能

• カウンター：

  • カウンターの値を増減させ、現在の値を取得します。

• 加法器：

  • 2つの整数を加算します。

• IP 検証器：

  • 文字列が有効な IPv4 アドレスかどうかを検証します。

• CIDR チェッカー：

  • IP アドレスが指定された CIDR 範囲内にあるかどうかをチェックします。

🔧 エンドポイント

• /sse：Server-Sent Events (SSE) をサポートするエンドポイントで、ツールの機能をリアルタイムで提供します。

🛠️ ツール

• インクリメント：カウンターの値を 1 増やします。
• デクリメント：カウンターの値を 1 減らします。
• 値の取得：現在のカウンターの値を取得します。
• 加算：2 つの数字を加算します。
• 有効な 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：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 ファイルを参照してください。