ezmcp

ezmcp

site icon
2025.03.08 17
PythonMCP服务器框架SSE传输开发效率
ezmcp是一个轻量级的MCP服务器框架,专门用于SSE(Server-Sent Events)传输。它提供了类似FastAPI的装饰器API,使得定义MCP工具变得简单。ezmcp支持自动参数验证、类型转换、工具模式生成,并内置了SSE传输支持。它还支持FastAPI风格的中间件,并可以轻松集成到现有的Starlette应用中。
View on GitHub

Overview

基本能力

产品定位

ezmcp是一个轻量级的MCP服务器框架,专门用于SSE(Server-Sent Events)传输,旨在简化MCP兼容服务器的创建过程。

核心功能

  • FastAPI风格的装饰器API,用于定义MCP工具
  • 自动参数验证和类型转换
  • 从函数签名自动生成工具模式
  • 内置SSE传输支持
  • FastAPI风格的中间件支持
  • 轻松集成到现有的Starlette应用中
  • 提供交互式文档页面,用于探索和测试工具

适用场景

  • 需要快速构建MCP兼容服务器的场景
  • 需要支持SSE传输的应用
  • 需要自动参数验证和类型转换的工具开发
  • 需要集成到现有Starlette应用中的场景

工具列表

  • echo:回显用户的消息

常见问题解答

  • 如何访问交互式文档?访问http://localhost:8000/docs
  • 如何连接到SSE端点?访问http://localhost:8000/sse

使用教程

使用依赖

安装ezmcp前需要确保已安装Python环境。

安装教程

pip install ezmcp

调试方式

  1. 运行服务器后,访问http://localhost:8000/docs查看交互式文档
  2. 连接到SSE端点http://localhost:8000/sse进行测试
  3. 使用以下命令进行开发和测试安装:
  4. 测试安装:pdm install -G test
  5. 开发安装:pdm install -G dev

许可证

该项目遵循 MIT 开源许可条款。