用途:使用 Speakeasy 从 OpenAPI 规范生成 MCP 服务器,把 API 操作暴露为 Claude 等 AI 助手可直接调用的工具。适用于希望让 AI 助手与自有 API 交互、需要 Model Context Protocol 集成的场景。
主要能力:生成 TypeScript MCP 服务器,每个 API 操作对应一个工具;提供带 stdio 与 SSE 传输的 CLI 入口;基于作用域(scope)的访问控制;Dockerfile 与 compose 配置;以及配置好的 .speakeasy/workflow.yaml。
必要用法:需先安装并认证 Speakeasy CLI(speakeasy auth login 或设置 SPEAKEASY_API_KEY),Node.js 20+,并准备有效的 OpenAPI 3.0/3.1 规范。先校验规范:speakeasy lint openapi --non-interactive -s ./openapi.yaml。随后创建 mcp-scopes-overlay.yaml 作用域覆盖文件、.speakeasy/workflow.yaml(target 使用 mcp-typescript,而非已弃用的 enableMCPServer)和 .speakeasy/gen.yaml,最后运行 speakeasy run 生成。使用时可执行 npx my-api-mcp mcp start --bearer-auth "YOUR_TOKEN",支持 --transport、--port、--scope、--tool 等参数,并可配置到 Claude Desktop 或 Claude Code。
限制与注意:不要直接修改源 OpenAPI 规范,应使用 overlay;不要硬编码令牌;不要暴露未审查的敏感端点;不要跳过规范校验;不要使用已弃用的 enableMCPServer 标志;不要缺少作用域覆盖文件;生成的服务器专用于 AI 助手集成,不应作为通用 SDK 使用。具体收费、价格与平台支持资料暂未提供。