Py MCP Sse

🚀 MCP客戶端與服務器Python樣例項目

本項目是一個MCP客戶端與MCP服務器的樣例實現（Python版本），於2025年3月30日創建。它優化自https://github.com/sidharthrajaram/mcp-sse，原項目基於https://github.com/modelcontextprotocol/python-sdk/issues/145的原始討論，你可下載原項目獲取更多說明。原版本使用ANTHROPIC LLM實現，本版本調整為使用OpenRouter.ai的LLM中轉調用平臺實現。

🚀 快速開始

本項目提供了基於SSE的 MCP 服務器和客戶端。

• mcp_server.py 是基於SSE的MCP服務器，提供了基於古騰堡計劃API的圖書搜索工具，改編自MCP文檔中的示例STDIO服務器實現。
• client.py 是MCP客戶端，可連接並使用基於SSE的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

💻 使用示例

運行服務

1. 啟動服務器

uv run mcp_server.py

或指定接口和端口：

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

2. 啟動客戶端

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