Po3 MCP

🚀 Poe o3 MCP 服務器

Poe o3 MCP 服務器是一個輕量級的模型上下文協議（MCP）服務器實現。它藉助 Poe 的 API，讓用戶能夠訪問 OpenAI 的 o3 模型以及其他模型。該服務器可將 Poe 的人工智能功能集成到任何 MCP 兼容的應用程序中，為開發者提供了極大的便利。

🚀 快速開始

先決條件

• 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 協議消息。

✨ 主要特性

• 使用 FastMCP 實現的簡單 MCP 服務器，易於搭建和使用。
• 直接與 Poe API 集成，可訪問 o3 模型和其它可用模型。
• 支持通過命令行風格標誌在提示中選擇模型，靈活切換不同模型。
• 採用異步請求處理，有效提高處理效率。
• 具備全面的錯誤處理和日誌記錄，方便排查問題。
• 安裝和配置簡單易行，降低使用門檻。

💻 使用示例

基礎用法

通過標誌選擇模型

您可以通過在提示中添加標誌來選擇 Poe 上的不同模型：

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

這將使您的查詢路由到 Claude - 3.5 - Sonnet 模型，而不是默認的 o3 模型。

該標誌可以在消息中的任何位置：

• 在開頭：--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 客戶端集成

此服務器提供兩個工具：

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)

📚 詳細文檔

配置

故障排除

1. 未找到 API 密鑰：
   • 檢查環境變量是否正確設置了POE_API_KEY。
2. 連接問題：
   • 確保服務器已啟動並正在監聽正確的端口。
   • 檢查防火牆設置，確保目標端口開放。
3. 依賴項錯誤：
   • 確保安裝了所有必需的 Python 包，參考requirements.txt文件。

📄 許可證

本項目遵循 MIT 許可證。更多信息請參見LICENSE文件。

致謝

感謝以下技術的支持和貢獻：

• FastMCP
• Poe API
• 開源社區的持續支持與協作