ezmcp

轻量级MCP服务器框架,用FastAPI语法快速构建SSE兼容服务

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:ezmcp。
它的用途是:轻量级MCP服务器框架,用FastAPI语法快速构建SSE兼容服务
完整的 Skill 内容见:https://321skill.com/skills/ezmcp/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

“帮我把这个本地数据库查询函数封装成一个MCP工具,让Claude能直接查询。”,开发者可以使用ezmcp,用几行装饰器代码快速定义一个Tool,框架会自动处理协议通信,使得Claude能立即调用这个新工具。或者,当需要快速将一个内部API暴露给AI助手时,用ezmcp能像写普通FastAPI路由一样快速完成集成。

介绍

ezmcp是一个专为简化MCP(Model Context Protocol)服务器开发而设计的轻量级框架。它旨在解决开发者在创建符合MCP协议、支持SSE(Server-Sent Events)通信的服务器时,面临的复杂配置和样板代码过多的问题。

该框架借鉴了FastAPI的简洁语法和设计理念,开发者只需使用熟悉的装饰器和类型注解,就能快速定义工具(Tools)、资源(Resources)和提示词(Prompts),并自动处理与MCP客户端(如Claude Desktop)的SSE连接和协议通信细节,极大降低了入门门槛。

它非常适合希望快速为AI Agent(如Claude)扩展自定义能力的后端开发者、全栈开发者以及智能体开发者。无论是想将内部工具、数据库或API暴露给AI使用,还是构建复杂的多工具集成服务,ezmcp都能提供高效的开发体验。

建议在使用前对MCP协议有基本了解。虽然框架简化了开发,但在处理高并发或需要复杂自定义中间件时,可能需要结合更底层的异步框架进行扩展。对于简单的工具封装,直接使用ezmcp可以显著提升开发效率。

核心特点

核心区别在于将FastAPI的优雅语法引入MCP服务器开发,让开发者能用定义API端点一样简单的方式定义AI可调用的工具和资源,无需手动处理SSE协议细节。相比从零搭建或使用更底层的库,它提供了更高层、更专注的抽象。

注意事项

不适合需要高度定制化网络层协议或脱离标准MCP/SSE通信模式的复杂场景。

常见问题

ezmcp和官方MCP SDK有什么区别?

ezmcp是基于官方SDK的轻量级封装框架,提供了更简洁的FastAPI风格API,专注于简化服务器创建,而官方SDK更底层、更灵活。

可以用ezmcp开发非SSE的MCP服务器吗?

目前ezmcp主要针对SSE传输协议进行了优化和简化,最适合开发SSE兼容的MCP服务器。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/ezmcp/raw/index.md 读取 ezmcp 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。