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 端點映射到 AI 模型可以呼叫的 MCP 工具。它還支援各種身份驗證方法（Bearer tokens、Basic auth 和 raw headers），並與 1Password 整合以進行安全的密鑰管理。

Who it’s for

  • Developers building web apps: Developers 想要為其服務提供 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 工具（如 jq 或 yq）搭配使用，以過濾或修改哪些 API 端點會被暴露為工具。
  • Multi-platform: 可透過 Homebrew、Docker 或作為 Linux 和 macOS 的預建二進位檔提供。