Microcks 是云原生、开源的 API 模拟与测试平台。开发者与测试人员可在开发、集成和测试阶段用它模拟 API 与服务,从而在缺乏完整生产就绪 API 的情况下构建和测试应用。官方文档见 https://microcks.io/documentation/。
该集成技能通过 Membrane CLI 与 Microcks 交互,Membrane 自动处理认证与凭据刷新,用户只需关注集成逻辑。
安装:npm install -g @membranehq/cli@latest
认证:membrane login --tenant --clientName=<agentType>(agentType 可为 claude、openclaw、codex、warp、windsurf 等)。无头环境会打印授权 URL,用户完成登录后执行 membrane login complete <code>。任意命令加 --json 可获得机器可读输出。
连接:membrane connection ensure "https://microcks.io/" --json,用户在浏览器完成认证,输出包含新连接 id。若状态为 BUILDING,可轮询 membrane connection get <id> --wait --json 直到 READY;若为 CLIENT_ACTION_REQUIRED 需按提示完成操作。
搜索动作:membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json,返回 id、名称、描述及输入输出 schema。
运行动作:membrane action run <actionId> --connectionId=CONNECTION_ID --json,传参用 --input '{"key": "value"}',结果在 output 字段。
代理请求:当动作不覆盖需求时,可用 membrane request CONNECTION_ID /path/to/endpoint 直接请求 Microcks API,Membrane 自动拼接基础 URL 并注入认证头与透明刷新。常用选项包括 -X/--method、-H/--header、-d/--data、--json、--rawData、--query、--pathParam。
涉及对象包括 API、测试、制品、仓库、消息、事件,以及 Keycloak 的用户、组、角色。建议优先用 Membrane 预建动作以处理认证、分页和错误,先发现再构建,并由 Membrane 管理凭据,不要向用户索取 API 密钥。具体可用动作清单及限制暂未提供。