用途：把 OpenAPI 规范（3.0/3.1）转换为 TypeScript MCP 服务器，使 Claude 等 AI 助手能直接调用 API 操作。适合希望让 AI 助手接入自有 API、生成 Claude 工具的开发者。
前提：需安装并认证 Speakeasy CLI（speakeasy auth login 或设置 SPEAKEASY_API_KEY），Node.js 20+，并提供有效 OpenAPI 规范。可先验证：speakeasy lint openapi --non-interactive -s ./openapi.yaml。
核心流程（无单条命令，按步骤配置后执行 speakeasy run）：
- 创建 mcp-scopes-overlay.yaml，用 x-speakeasy-mcp 为操作设置 scopes 和 disabled，控制哪些操作成为工具；
- 创建 .speakeasy/workflow.yaml，sources 引用规范与 overlay，targets 使用 mcp-typescript；
- 创建 .speakeasy/gen.yaml，配置 packageName、envVarPrefix 等；
- 运行 speakeasy run 生成项目，内含每操作一个工具、CLI 入口、作用域定义、Docker 支持。
使用：通过 npx 启动，如 npx my-api-mcp mcp start --bearer-auth "YOUR_TOKEN"，可用 --transport stdio|sse、--port、--scope、--tool 过滤，并接入 Claude Desktop 或 Claude Code 配置。生产中可用 Docker 与 SSE。
限制与注意：不要直接修改源规范，应使用 overlay；不要把令牌硬编码进配置文件；不要暴露全部操作，应禁用敏感端点；不要使用已弃用的 enableMCPServer: true，改用独立 mcp-typescript 目标；该服务器专为 AI 助手集成，不应当作通用 SDK。生成失败或工具缺失时，先验证规范并检查 overlay 是否被 workflow 引用。