用途:把 Apidog 或后端导出的 OpenAPI 3.0/3.1 规范接入 React 应用,让 AI 代理始终基于最新规范生成类型并实现功能。
主要能力:配置 apidog-mcp-server 读取远程 URL 或本地 OpenAPI 文件;支持同时接入多个 API;生成或手写 TypeScript 类型;用 Zod 做运行时校验;搭建 axios HTTP 客户端与鉴权刷新拦截器;按功能组织 TanStack Query 的查询与变更钩子,并使用查询键工厂管理缓存失效。
使用方式:先导出 OpenAPI 规范并托管为 URL 或放入项目(如 ./api-spec/openapi.json);在 .claude/mcp.json 中配置 MCP 服务器,命令为 npx -y apidog-mcp-server@latest --oas=<规范地址>;在 /src/api 下组织 types.ts、client.ts、queries/、mutations/;大型 API 可用 npx openapi-typescript <url> -o src/api/types.ts 或 npx orval --input <url> --output src/api 生成代码。
适用场景:React 前端与 OpenAPI 后端联调、需要类型安全与统一数据源的 API 层建设。
限制:资料未提供收费、价格、平台支持范围与效果数据;具体实现依赖 Apidog、TanStack Query、Zod、axios 等外部工具,需自行安装配置。