Py MCP Sse

🚀 MCP クライアントとサーバのPython実装サンプル

このプロジェクトは 2025 年 3 月 30 日に構築され、MCP クライアントと MCP サーバのPythonバージョンのサンプル実装です。 このプロジェクトは https://github.com/sidharthrajaram/mcp-sse をベースに最適化されています。元のプロジェクトは https://github.com/modelcontextprotocol/python-sdk/issues/145 の初期議論に基づいており、元のプロジェクトをダウンロードすると詳細な説明が得られます。 元のバージョンは ANTHROPIC LLM を使用して実装されていましたが、このバージョンでは OpenRouter.ai の LLM 中継呼び出しプラットフォームを使用するように調整されています。

🚀 クイックスタート

このセクションでは、MCP サーバとクライアントのセットアップと実行方法を説明します。

✨ 主な機能

• このプロジェクトは、SSE ベースの MCP サーバとクライアントを提供します。
• mcp_server.py は、SSE ベースの MCP サーバで、古騰堡計画 API に基づく書籍検索ツールを提供します。これは MCP ドキュメントの サンプル STDIO サーバ実装 を改変したものです。
• client.py は、SSE ベースの MCP サーバが提供するツールを接続して使用できる MCP クライアントです。これは MCP ドキュメントの サンプル STDIO クライアント実装 を改変したものです。

📦 インストール

システム要件

• Python 3.13 以上
• uv パッケージマネージャ（推奨）または pip

インストール手順

1. プロジェクトのクローン

git clone [your-repository-url]
cd jay-py-mcp-sse

2. 環境の設定

uv を使用する場合（推奨）：

# uv のインストール（未インストールの場合）
curl -LsSf https://astral.sh/uv/install.sh | sh

# 仮想環境の作成と依存関係のインストール
uv venv
uv pip install .

または、従来の pip を使用する場合：

# 仮想環境の作成
python -m venv .venv
source .venv/bin/activate  # Linux/MacOS
# または
.venv\Scripts\activate  # Windows

# 依存関係のインストール
pip install .

3. 環境変数の設定

環境変数のサンプルファイルをコピーし、必要な情報を記入します：

cp .env.sample .env

.env ファイルを編集し、OpenRouter API キーを入力します：

OPENROUTER_API_KEY=your_api_key_here

💻 使用例

基本的な使用法

サーバの起動

uv run mcp_server.py

または、インターフェースとポートを指定する場合：

uv run mcp_server.py --interface "0.0.0.0" --port 8000

クライアントの起動

uv run client.py

実行時のサンプル出力

[2025-03-30T16:00:00+00:00] INFO - Server is running on http://localhost:8000
[2025-03-30T16:00:01+00:00] INFO - Client connected to server at http://localhost:8000
[2025-03-30T16:00:02+00:00] INFO - Available tools: search_books, recommend_books

📚 ドキュメント

プロジェクト構造

jay-py-mcp-sse/
├── mcp_server.py          # SSE ベースの MCP サーバの実装
├── client.py              # MCP クライアントの実装
├── README.md               # プロジェクトの説明ドキュメント
└── .env.sample            # 環境変数のサンプルファイル

トラブルシューティング

1. Python バージョンの確認
   • Python 3.13 以上を使用していることを確認してください。
2. 環境変数の設定の確認
   • .env ファイルの OPENROUTER_API_KEY が正しく記入されていることを確認してください。
3. 起動に関する問題
   • サーバまたはクライアントが起動しない場合は、コンソール出力のエラーメッセージを確認してください。
   • すべての依存関係が正しくインストールされていることを確認してください。
4. 接続に関する問題
   • クライアントがサーバに接続できない場合は、ネットワーク設定とポートが正しいことを確認してください。

ヘルプの取得

問題が発生した場合は、プロジェクトドキュメントを参照するか、GitHub リポジトリで問題を報告してください： https://github.com/yourusername/jay-py-mcp-sse