Pymcp Sse

🚀 pymcp - sse：Python MCP over SSE ライブラリ

軽量で柔軟な Python アプリケーションのモデルコンテキストプロトコル（MCP）の実装で、HTTP/SSE ベースの堅牢な伝送に特化しています。

✨ 主な機能

• モジュール化フレームワーク：BaseMCPServer、BaseMCPClient、MultiMCPClient がきれいに実装されています。
• HTTP/SSE 伝送：自動セッション管理、設定可能なタイムアウト、再接続処理を備えた堅牢な HTTP/SSE 実装です。
• 並行タスク実行：BaseMCPServer.run_with_tasks() メソッドにより、永続的なバックグラウンド非同期タスクを持つサーバーを簡単に実行できます。
• ツール登録と発見：シンプルなデコレータベースのツール登録（@server.register_tool()）と標準の describe_tools エンドポイントを備え、クライアントが詳細なツール機能（パラメータ、説明）を動的に照会できます。
• サーバープッシュ：サーバーからクライアントへのプッシュ通知と定期的なハートビート検出のサポートが組み込まれています。NotificationScheduler 補助クラスも含まれています。
• LLM 統合：MCP プロトコルを介して LLM（Claude 2 など）と統合し、自然言語での対話をサポートします。

📦 インストール

ライブラリをインストールするには、ターミナルで以下のコマンドを実行してください。

pip install pymcp - sse

開発モードでインストールする（ドキュメントとテストを含む）には、以下を使用してください。

pip install -e .

リリース後は PyPI を通じてインストールできるようになり、pip install pymcp - sse でインストールできます。

📚 ドキュメント

詳細な使い方、HTTP/SSE の実装説明、LLM 統合ガイド、プロトコル仕様については、docs/ ディレクトリ内のドキュメントを参照してください。

💻 使用例

examples/ ディレクトリには、以下を含む完全な実行例が用意されています。

• server_basic：server.run() を使用した簡単なサーバーのデモ。
• server_tasks：バックグラウンドタスク（通知スケジューラー）を持つサーバーのデモで、server.run_with_tasks() を使用します。
• client：MultiMCPClient と LLMAgent を使用して、2 つのサーバーと自然言語で対話するマルチサーバークライアント。API キーが必要です（プロジェクトのルートディレクトリで .env ファイルに ANTHROPIC_API_KEY を設定）。
• run_all.py：server_basic、server_tasks、client を同時に簡単に起動する起動スクリプト。
• notification_listener.py：互換性のあるサーバーからの通知を受信する簡単な独立したクライアント。

📚 ドキュメント

完全な API ドキュメントと使い方ガイドについては、[pymcp - sse ドキュメント](https://github.com/yourusername/pymcp - sse/blob/main/docs/index.md)を参照してください。

📄 ライセンス

MIT