ezmcp

ezmcp

专为 SSE 打造的易用 MCP 服务框架。

概述

ezmcp 是一个轻量级框架，使用类似 FastAPI 的语法即可轻松创建兼容 MCP 的服务。它提供了基于装饰器的简单 API，用于定义可由 MCP 客户端调用的工具。

功能

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

安装

pip install ezmcp

快速开始

from ezmcp import ezmcp, TextContent

# Create an ezmcp application
app = ezmcp("my-app")

# Define a tool
@app.tool(description="Echo a message back to the user")
async def echo(message: str):
    """Echo a message back to the user."""
    return [TextContent(type="text", text=f"Echo: {message}")]

# Run the application
if __name__ == "__main__":
    app.run(host="0.0.0.0", port=8000)

服务运行后，你可以：

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

中间件

ezmcp 支持类似 FastAPI 的中间件，可添加应用程序全局生效的行为。

from starlette.requests import Request

from ezmcp import TextContent, ezmcp

app = ezmcp("my-app")

@app.middleware
async def process_time_middleware(request: Request, call_next):
    """Add a header with the processing time."""
    import time
    start_time = time.perf_counter()
    response = await call_next(request)
    process_time = time.perf_counter() - start_time
    response.headers["X-Process-Time"] = str(process_time)
    return response

@app.tool(description="Echo a message back to the user")
async def echo(message: str):
    """Echo a message back to the user."""
    return [TextContent(type="text", text=f"Echo: {message}")]

有关中间件的更多信息，请参阅中间件文档。

文档

如需更详细的文档，请参阅 ezmcp/README.md 文件。

许可证

MIT

命令

• 安装测试依赖 pdm install -G test
• 安装开发依赖 pdm install -G dev