mattt/emcee

MCP generator for OpenAPIs 🫳🎤💥

What it solves

emcee 解决了为每个 Web 应用程序手动创建 Model Context Protocol (MCP) 服务器的问题。它允许用户立即将任何具有 OpenAPI 规范的 Web 应用程序转换为 MCP 服务器,使 AI 模型(如 Claude Desktop)能够与外部工具和数据服务进行交互,而无需构建自定义的服务器实现。

How it works

emcee 作为 AI 客户端与 Web API 之间的桥梁。它接收 OpenAPI 规范(通过 URL 或本地文件),并使用 JSON-RPC 2.0 实现 MCP stdio 传输。它将 OpenAPI 规范中定义的 API 端点映射到 MCP 工具,使 AI 模型可以调用。它还支持多种身份验证方法(Bearer tokens、Basic auth 和 raw headers),并与 1Password 集成以进行安全的密钥管理。

Who it’s for

  • Developers building web apps: 想要为自己的服务提供 AI 访问权限,而无需构建专门的 MCP 服务器或客户端库。
  • AI Power Users: MCP 相容客户端(使用 Claude Desktop 等)的用户,想要连接到任何提供 OpenAPI 规范的 API。

Highlights

  • Instant MCP Server: 直接将 OpenAPI 规范转换为功能性的 AI 工具。
  • Secure Authentication: 支持 Bearer、Basic 和 raw auth,并与 1Password CLI 集成以进行安全的密钥管理。
  • OpenAPI 3.2 Support: 包含对 HTTP QUERY 方法(RFC 10008)的支持。
  • Flexible Transformation: 可与 Unix 工具(如 jqyq)搭配使用,以过滤或修改哪些 API 端点被暴露为工具。
  • Multi-platform: 可通过 Homebrew、Docker 或作为 Linux 和 macOS 的预构建二进制文件提供。