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 许可证。