Pymcp Sse

🚀 pymcp - sse：Python MCP over SSE 庫

pymcp - sse 是一個輕量級且靈活的 Python 庫，它實現了應用程序模型上下文協議（MCP），專注於基於 HTTP/SSE 實現穩健的傳輸，為相關開發提供了便利。

🚀 快速開始

pymcp - sse 是一個強大的 Python 庫，用於實現 MCP 協議。你可以按照以下步驟快速開始使用它。

✨ 主要特性

• 模塊化框架：乾淨利落地實現了 BaseMCPServer、BaseMCPClient 和 MultiMCPClient，便於開發者進行模塊化開發和使用。
• HTTP/SSE 傳輸：具備自動會話管理、可配置超時和重新連接處理的穩健 HTTP/SSE 實現，保障數據傳輸的穩定性。
• 併發任務執行：通過 BaseMCPServer.run_with_tasks() 方法，能夠輕鬆運行帶有持久背景異步任務的服務器，提高服務器的併發處理能力。
• 工具註冊與發現：使用簡單的裝飾器（@server.register_tool()）進行工具註冊，並提供標準 describe_tools 端點，允許客戶端動態查詢詳細工具功能（參數、描述）。
• 服務器推送：內置支持服務器向客戶端發起推送通知和定期心跳檢測，包含 NotificationScheduler 輔助類，方便實現服務器推送功能。
• LLM 集成：可通過 MCP 協議與 LLM（如 Claude 2）集成，支持自然語言交互，拓展了庫的應用場景。

📦 安裝指南

常規安裝

要安裝該庫，請在終端中運行以下命令：

pip install pymcp-sse

開發模式安裝

若要在開發模式下安裝（包括文檔和測試），請使用以下命令：

pip install -e .

發佈後的安裝將通過 PyPI 提供，屆時可以使用 pip install pymcp-sse 進行安裝。

💻 使用示例

在 examples/ 目錄中提供了完整的運行示例，以下是部分示例介紹：

基礎用法

server_basic

演示使用 server.run() 的簡單服務器。

# 示例代碼可參考 examples/server_basic 目錄下的代碼

高級用法

server_tasks

演示帶有背景任務（通知調度器）的服務器，使用 server.run_with_tasks()。

# 示例代碼可參考 examples/server_tasks 目錄下的代碼

client

一個多服務器客戶端，使用 MultiMCPClient 和一個 LLMAgent 來與兩個服務器進行自然語言交互。需要 API 密鑰（在項目根目錄中設置 ANTHROPIC_API_KEY 到 .env 文件）。

# 示例代碼可參考 examples/client 目錄下的代碼

run_all.py

一個啟動腳本，輕鬆同時啟動 server_basic、server_tasks 和 client。

# 示例代碼可參考 examples/run_all.py 文件

notification_listener.py

一個簡單的獨立客戶端，用於接收任何兼容服務器的通知。

# 示例代碼可參考 examples/notification_listener.py 文件

📚 詳細文檔

有關詳細用法、HTTP/SSE 實現說明、LLM 集成指南以及協議規範，請參閱 docs/ 目錄中的文檔。完整的 API 文檔和使用指南請參閱 [pymcp - sse 文檔](https://github.com/yourusername/pymcp - sse/blob/main/docs/index.md)。

📄 許可證

本項目採用 MIT 許可證。