MCP Server Python

🚀 MCP 服務器演示（Python 版）

本項目提供了一個簡單的 Model Communication Protocol (MCP) 服務器的 Python 實現。它能展示 MCP 服務器的基本功能，可用於測試和開發。服務器默認藉助 uvicorn 運行，監聽端口為 8000。若要將服務器暴露到網絡中，需使用 sse 傳輸。

🚀 快速開始

安裝依賴

創建並激活虛擬環境，運行以下命令來設置 Python 環境：

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

啟動服務器

python3 server.py

驗證服務器是否在運行

你可以使用以下命令驗證服務器是否在端口 8000 上運行：

• 檢查活動連接：

  netstat -n | grep 8000
  

• 檢查佔用端口的進程：

  lsof -i :8000
  

• 使用 curl 測試服務器：

  curl http://0.0.0.0:8000/sse
  

📦 安裝指南

創建並激活虛擬環境

運行以下命令來設置 Python 環境：

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

💻 使用示例

與工具集成

要將此服務器與工具（如 Cursor 或 Claude）集成，請使用以下 mcp.json 配置文件：

{
  "mcpServers": {
    "demo-server": {
      "transport": "sse",
      "url": "http://localhost:8000/sse"
    }
  }
}

📚 詳細文檔

運行測試

該項目包含一個全面的測試套件，使用 pytest。要運行測試：

# 安裝測試依賴項
pip install -r requirements.txt

# 以詳細輸出運行測試
pytest -v

# 生成覆蓋率報告運行測試
pytest --cov=.

測試範圍

測試套件包括以下內容：

• 基本功能測試（加法和減法）
• 輸入驗證和類型檢查
• 大數邊界情況
• API 端點測試（問候語）

所有測試均位於 test_server.py 中，並涵蓋：

• add() 函數
• subtract() 函數
• get_greeting() 函數
• 類型錯誤處理
• 邊界情況處理

⚠️ 注意事項

⚠️ 重要提示

• 默認情況下，服務器使用 stdio 傳輸。要將其暴露到網絡中，請確保配置為使用 sse 傳輸。
• 該服務器運行在 localhost 上，並監聽端口 8000 使用 uvicorn。

如有任何問題，請隨時貢獻或提出問題！