Po3 MCP

🚀 Poe o3 MCP サーバー

このサーバーは、軽量なモデルコンテキストプロトコル（MCP）サーバーの実装で、PoeのAPIを通じてOpenAIのo3モデルやその他のモデルにアクセスできます。PoeのAI機能を、MCP互換のアプリケーションに簡単に統合できます。

✨ 主な機能

• FastMCPを使用したシンプルなMCPサーバー
• Poe APIと直接統合し、o3モデルやその他の利用可能なモデルにアクセス
• コマンドラインスタイルのフラグを使用して、プロンプト内でモデルを選択
• 非同期リクエスト処理による効率向上
• 包括的なエラー処理とログ記録
• 簡単なインストールと設定

📦 インストール

前提条件

• Python 3.8以上
• Poe APIキー（https://poe.com/api_key から取得可能）

インストール手順

1. このリポジトリをクローンします：

   git clone https://github.com/Anansitrading/po3_MCP.git
   cd po3_MCP
   

2. 仮想環境を作成します（推奨）：

   python -m venv venv
   source venv/bin/activate  # Windowsの場合は：venv\Scripts\activate
   

3. 必要な依存関係をインストールします：

   pip install -r requirements.txt
   

4. 環境変数を設定します：

   cp sample.env .env
   

5. .envファイルを編集し、Poe APIキーを追加します：

   POE_API_KEY=your_poe_api_key_here
   

💻 使用例

MCPサーバーの起動

サーバーを以下のコマンドで起動します：

python poe_o3_mcp_server.py

サーバーは起動し、標準入出力でMCPプロトコルのメッセージを待ち受けます。

フラグを使用したモデルの選択

プロンプトにフラグを追加することで、Poe上の異なるモデルを選択できます。

--Claude-3.5-Sonnet Tell me about quantum computing

これにより、クエリはデフォルトのo3モデルではなく、Claude-3.5-Sonnetモデルにルーティングされます。

フラグはメッセージ内の任意の位置に配置できます：

• 先頭：--GPT-4 What is the capital of France?
• 途中：Tell me --Claude-3-Opus about the history of Rome
• 末尾：What are the three laws of robotics? --Claude-3.5-Sonnet

フラグはメッセージがモデルに送信される前に自動的に削除されます。 フラグが指定されていない場合は、デフォルトで“o3”モデルが使用されます。

MCPクライアントとの統合

このサーバーは2つのツールを提供します：

1. o3_query - o3モデル（またはフラグで選択された他のモデル）にクエリを送信し、応答を取得
2. ping - 簡単なテストツールで、“pong”を返す

MCPクライアントを使用してツールを呼び出す例：

from mcp.client import MCPClient

# MCPサーバーに接続
client = MCPClient(server_command=["python", "path/to/poe_o3_mcp_server.py"])

# o3_queryツールを呼び出し、デフォルトでo3モデルを使用
response = client.call_tool("o3_query", {"message": "Tell me about quantum computing"})
print(response)

# フラグを使用してo3_queryツールを呼び出し、他のモデルを選択
response = client.call_tool("o3_query", {"message": "Hello, what is AI?"})
print(response)

# pingツールを呼び出して接続をテスト
response = client.call_tool("ping", {})
print(response)

📚 ドキュメント

設定

• POE_API_KEY：必須。Poe APIにアクセスするためのキーで、デフォルトは空です。
• MCP_SERVER_PORT：オプション。サーバーがリッスンするポートを設定します。デフォルトは5000です。

トラブルシューティング

1. APIキーが見つからない場合：
   • 環境変数にPOE_API_KEYが正しく設定されていることを確認してください。
2. 接続問題：
   • サーバーが起動し、正しいポートをリッスンしていることを確認してください。
   • ファイアウォール設定を確認し、ターゲットポートが開いていることを確認してください。
3. 依存関係エラー：
   • requirements.txtファイルを参照し、すべての必須Pythonパッケージがインストールされていることを確認してください。

📄 ライセンス

このプロジェクトはMITライセンスに従います。詳細については、LICENSEファイルを参照してください。

謝辞

以下の技術のサポートと貢献に感謝します：

• FastMCP
• Poe API
• オープンソースコミュニティの継続的なサポートと協力