← 返回目录
P

Postman MCP Server

社区
通过 MCP 访问 Postman API 的服务器
GitHub 源仓库 ↗
★ 157 Stars 分类 · 开发工具 热门
49FMRS · D

一个社区开发的 TypeScript MCP 服务器,将 Postman API 的集合、环境、API 管理、权限、Webhook 等能力暴露给 AI 客户端。功能覆盖面广,支持 Claude Desktop、Cline 和 Smithery 安装,但处于早期开发阶段且为 AI 生成代码,适合愿意承担一定风险的高级用户。

可靠性
7/20
安全与权限
8/20
维护活跃度
9/20
文档质量
13/20
安装易用性
12/20
查看 FMRS 评分方法 →

Postman MCP Server 是一个基于 TypeScript 的 MCP 服务器,集成 Postman API,提供对 Postman 集合(Collections)、环境(Environments)和 API 的全面管理,功能基于 Postman 官方 OpenAPI 规范。项目仍处于活跃开发阶段,可能存在破坏性变更。

安装接入

  1. 安装 Node.js;2. 克隆仓库并进入目录;3. 运行 pnpm install 安装依赖;4. 运行 pnpm run build 构建;5. 在 Postman 账户设置中生成 API Key 并配置为 POSTMAN_API_KEY 环境变量;6. 在 Claude Desktop 或 Cline 配置文件中添加服务器配置;也可通过 Smithery 自动安装:npx -y @smithery/cli install postman-api-server --client claude。
claude_desktop_config.json
{"mcpServers":{"postman":{"command":"node","args":["/path/to/postman-api-server/build/index.js"],"env":{"POSTMAN_API_KEY":"CHANGEME"}}}}

选型与风险

适合谁

  • 需要在 AI 助手中执行复杂多步骤 Postman 操作的团队
  • 需要自动化测试工作流和 API 文档维护的开发者
  • 管理大量集合与环境的 Postman 用户

不适合谁

  • 只需简单运行集合或单次 API 调用的用户
  • 习惯直接使用 CLI 的本地快速迭代场景
  • 寻求 Postman 官方维护服务器的用户(本项目为社区开发)

所需权限

  • 需要具有相应资源权限的 Postman API Key(POSTMAN_API_KEY)
  • API Key 可访问该账户下所有有权访问的 Postman 资源
  • 支持基于角色的工作区和集合级权限管理

风险与副作用

  • 项目处于活跃开发阶段,可能存在破坏性变更
  • 代码为 AI 生成(Cline + Claude 3.5 Sonnet),需谨慎审查
  • API Key 权限范围广,泄露可能导致 Postman 资源被修改或删除
  • 服务器通过 stdio 通信,调试相对困难

常见排障

  1. 确认已正确设置 POSTMAN_API_KEY 环境变量
  2. 确认已运行 pnpm run build 生成 build/index.js
  3. 使用 MCP Inspector(pnpm run inspector,http://localhost:5173)调试,连接前需添加 API Key
  4. 更新服务器后需重启 Claude Desktop,因其会缓存工具定义
  5. 通过简单的查询(如列出工作区)验证 API Key 访问权限

使用场景

管理多个 Postman 集合与文件夹
通过 AI 自动化测试与文档维护
协调多环境管理与配置
对错误敏感的 API 测试与合规检查

支持客户端

Claude Desktop完整支持
Cline完整支持
Zed部分支持