SuperAPI AI 工具集

postman

编程与开发

查看项目

更新于 10-16 03:46

技能介绍

用途:Postman Agent Skill 面向 API 全生命周期管理,通过 Postman MCP Server 操作 Postman 的工作区、集合、规范、环境、Mock、监控等资源,提供 111+ 个工具。

主要能力:按用户意图路由到不同工作流,包括同步集合(OpenAPI 规范与集合双向同步)、生成客户端代码(依据集合与规范生成类型化客户端,自动检测项目语言与变量命名不匹配)、发现 API(用自然语言搜索私有工作区端点与响应结构)、运行集合测试(执行并基于聚合结果诊断失败)、创建 Mock 服务器(从集合或规范生成并发布)、API 文档(分析覆盖率并补全或发布文档)、API 安全审计(对照 OWASP API Security Top 10)。

使用方式:需先配置 Postman MCP Server 并获取 API Key,设置环境变量 export POSTMAN_API_KEY=PMAK-your-key-here,可写入 ~/.zshrc 或 ~/.bashrc 持久化。通过调用 getAuthenticatedUser 验证连接,成功后用 getWorkspaces、getCollections 等工具操作。优先使用结构化工作流而非直接调用 mcp__postman__* 工具,仅在单点更新或用户明确要求时直接调用。创建规范使用 createSpec,类型可选 OPENAPI:2.0、OPENAPI:3.0、OPENAPI:3.1、ASYNCAPI:2.0,集合生成与同步为异步(HTTP 202),需轮询任务状态。

限制:getWorkspaces 返回全部工作区,大组织可能超 300KB;getCollection 默认返回轻量结构,model=full 可能超 300KB;getTaggedEntities 对缺失标签返回 404 而非空数组,且标签功能可能需企业版;runCollection 仅返回聚合结果,不含逐请求详情;searchPostmanElements 只搜索公开网络,不搜索私有工作区;syncCollectionWithSpec 仅支持 OpenAPI 3.0,Swagger 2.0 或 OpenAPI 3.1 需改用 updateSpecFile 并重新生成集合。具体收费与价格信息暂未提供。