echo-mcp 是一个面向 Go 语言 Echo Web 框架的 MCP 包装库,目标是将已有的 Echo API 转换为 MCP(Model Context Protocol)工具,从而让 AI 助手或 AI 智能体能够与你的 Echo API 进行交互。该项目受 gin-mcp 启发,但专门适配 Echo 框架。
主要能力
- 零配置:可配合任何现有的 Echo API 使用。
- 多种 Schema 来源:支持 Swaggo、原始 OpenAPI YAML/JSON,以及手动注册的 Schema。
- 过滤功能:通过通配符模式包含或排除端点。
- MCP 兼容:可与任何支持 MCP 的智能体协同工作。
- 服务启动后,API 可通过 http://localhost:8080/mcp 访问。
Schema 生成方式 Echo-MCP 支持四种 Schema 生成方法,并带有自动回退机制:
- 自动 Swagger Schema:如果你已使用 Swaggo 生成 Swagger 文档,可启用自动 Schema 生成。
- 原始 OpenAPI Schema 支持:如果你使用其他 OpenAPI 库(如 swaggest/openapi-go),可以传入原始 YAML 或 JSON 格式的 Schema 字符串。OpenAPISchema 字段同时接受 YAML 和 JSON 格式字符串,提供后会从 Schema 中自动填充:服务器名称(来自 Schema 标题)、描述(来自 Schema 描述)、版本(来自 Schema 版本),以及工具 Schema(来自操作定义)。
- 端点过滤:可只向 MCP 工具暴露必要的端点。
- 手动 Schema 注册(开发中):为获得更好的控制,可手动注册 Schema。
使用方式
- 在项目中集成 Echo-MCP 后,启动 Echo 服务,MCP 端点默认位于 http://localhost:8080/mcp。
- MCP 客户端集成:服务器运行后,可在支持 MCP 的客户端中进行配置。
- 手动配置:文档提供了手动配置方式。
- 本地测试:可使用 MCP Inspector 进行本地测试。
适用场景
- 希望让 AI 助手或智能体直接操作现有 Echo API 的开发者。
- 已有 Swaggo 或 OpenAPI 文档,想快速将 API 暴露为 MCP 工具的项目。
- 需要对暴露给 AI 的端点进行筛选和控制的场景。
限制与暂未提供信息
- 手动 Schema 注册功能标记为 WIP(开发中)。
- 关于收费、价格、平台支持、具体性能效果等信息,资料中暂未提供。
项目还致谢了 Swaggo(Swagger 文档生成器)、swaggest/openapi-go(Go 的 OpenAPI 3.0 工具包)、Echo Framework(高性能 Go Web 框架)、Echo Swagger(Echo 的 Swagger UI 中间件)以及 Model Context Protocol(AI 工具交互的通用协议)。