emcee 是一个为任何具有 OpenAPI 规范的 Web 应用提供 Model Context Protocol（MCP）服务器的工具。使用 emcee，你可以将 Claude Desktop 和其他应用连接到外部工具与数据服务，类似于 ChatGPT 插件。
用途 emcee 的核心用途是为已有的 OpenAPI 规范自动生成 MCP 服务器，使 AI 模型能够通过标准化协议调用 Web 应用提供的接口。对于尚无现成 MCP 服务器实现的服务，尤其是用户正在自行开发的服务，emcee 提供了一种便捷的接入方式。如果 Web 应用已有 OpenAPI 规范，无需额外的仪表盘或客户端库即可尝试接入。
主要能力
- 根据 OpenAPI 规范生成 MCP 服务器，供 Claude Desktop 等支持 MCP 的应用使用。
- 实现 MCP 的 Standard Input/Output（stdio）传输，采用 JSON-RPC 2.0 作为线格式。从命令行运行 emcee 时，程序监听 stdin、输出到 stdout、日志写入 stderr。
- 支持需要认证的 API，提供多种认证方式，认证值可直接提供或使用 1Password 密钥引用（格式为 op://vault/item/field）。使用 1Password 引用时需安装 1Password CLI 并确保在 PATH 中，且在运行 emcee 或启动 Claude Desktop 前登录 1Password。
- 支持 RFC 10008 定义的 HTTP QUERY 方法：OpenAPI 3.2 规范可使用原生 query Path Item 操作；较旧的 OpenAPI 3.x 规范可使用 x-query 兼容扩展，其值按标准 OpenAPI Operation Object 解析，注册为 MCP 工具，并标注为只读和幂等。
- 提供预构建的发布版本安装脚本（支持 Linux x86-64/i386/arm64 和 macOS Intel/Apple Silicon）、Homebrew 安装以及预构建 Docker 镜像。
- 可从源码构建，要求 Go 1.24 或更高版本。构建后可在原地运行（./emcee）或移动到 PATH 中的位置，如 /usr/local/bin。
- 可与 jq、yq、OpenAPI Overlays、Redocly 等 Unix 工具配合，在传入 emcee 前转换 OpenAPI 规范，例如仅选择特定端点（如使用 jq 只包含 weather.gov 的 point 工具）、修改描述或参数、合并多个规范。
- 支持通过直接发送 JSON-RPC 请求与所提供的 MCP 服务器交互。
使用方式 以 Claude Desktop 为例，配置步骤包括：打开 Claude Desktop 设置（⌘ ,），在侧边栏选择“Developer”部分，点击“Edit Config”打开配置文件（位于 Application Support 目录，也可用 VSCode 直接打开）。添加相应配置以接入 weather.gov MCP 服务器。保存文件后退出并重新打开 Claude，聊天框右下角会出现 🔨57 标记，点击可查看通过 MCP 提供给 Claude 的所有工具。新建对话并询问天气，Claude 会查询可用工具，若认为合适会请求使用，用户可以批准或拒绝。若允许，Claude 将与 MCP 通信并使用结果生成回答。
需注意，emcee 在从作为命令行参数提供的 URL 下载 OpenAPI 规范时不使用认证凭据。如果 OpenAPI 规范本身需要认证才能访问，应先用 HTTP 客户端下载到本地文件，再将本地文件路径提供给 emcee。
适用场景
- 将 Claude Desktop 等支持 MCP 的应用连接到外部工具和数据服务。
- 为已有 OpenAPI 规范但缺少 MCP 服务器实现的 Web 应用快速生成 MCP 接入层。
- 在开发自有 Web 服务时，通过 OpenAPI 规范快速提供 MCP 工具能力。
- 使用 MCP Inspector（用于测试和调试 MCP 服务器的工具）排查 Claude 和/或 emcee 的工作异常。
限制 emcee 仅提供 MCP 工具能力，暂不支持资源（resources）、提示（prompts）和采样（sampling）等功能。使用 1Password 密钥引用时需满足相应前置条件。从 URL 下载 OpenAPI 规范时不使用认证凭据。
许可 本项目基于 MIT 许可证发布，详见 LICENSE 文件。
