Postman MCP Server

社区

通过 MCP 访问 Postman API 的服务器

分类: 开发工具第 272 / 438
Stars: ★ 158 热门
传输方式: stdio（本地进程）
运行环境: Node.js
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 15 个月前 ⚠

49FMRS · D

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

最强项 · 文档质量 13/20 最弱项 · 可靠性 7/20

可靠性

7/20

安全与权限

8/20

维护活跃度

9/20

文档质量

13/20

安装易用性

12/20

查看各项评分依据

可靠性 7/20: README 明确标注项目处于「积极开发中，请谨慎使用，预计有破坏性变更」，且代码由 Cline + Claude 3.5 Sonnet 生成（AI 生成代码提示）。全文没有出现任何自动化测试、CI 工作流或错误处理机制的描述，调试仅依赖手动运行 MCP Inspector。由于本次为静态审查且未见任何可验证的测试或 CI 证据，按规定评分不得超过 12 分；结合上述破坏性变更警告与测试证据缺失，判定为 7 分（happy path 可能可行，但错误处理和边界情况证据薄弱）。
安全与权限 8/20: API 密钥通过环境变量 POSTMAN_API_KEY 传入，README 提醒「切勿将密钥提交到版本库」，属于基本的安全意识。但功能列表中包含大量删除类操作（删除 Collection、Environment、API 等），文档中未提及任何删除前确认机制或操作范围限定；同时说明「该 API 密钥可访问用户在 Postman 中拥有权限的所有资源」，缺乏最小权限/作用域收窄的设计说明，也未披露数据在本地与 Postman/第三方（如 Smithery）之间的流转边界。这些是文档证据缺失导致的扣分项，而非确凿的红线证据（示例配置中密钥为占位符 CHANGEME，非真实密钥），故未触发红线，评为 8 分。
维护活跃度 9/20: 项目采用 MIT 许可证，版本号 v0.2.0，未被归档（Archived: False），157 星、10 个未关闭 issue，比例尚属健康，表明有一定关注度和活跃度。但 README 未提及发布节奏、变更日志、依赖更新策略或安全问题反馈渠道（如 SECURITY.md），且明确自称处于早期活跃开发阶段，治理与版本化尚不成熟，故评为 9 分。
文档质量 13/20: README 结构完整，含目录、功能说明、安装步骤、Claude Desktop/Cline 配置示例、调试指南，并引用了 docs/ 下的 API 参考、摘要和处理程序文档，整体文档层次较丰富。但 README 本身未直接列出各 MCP 工具的具体参数/输入模式（需跳转到外部文档），未给出速率限制或成本的具体数值（仅链接至 Postman 官方文档），Zed 客户端支持被作者坦承「仍在尝试」，故信息尚不完整。综合评为 13 分。
安装易用性 12/20: 安装步骤清晰（clone、pnpm install、pnpm run build、pnpm run watch），并提供了 Smithery 一键安装选项和 Claude Desktop/Cline 的 JSON 配置示例，具备基本的跨客户端安装指导。但配置需要手动编辑绝对路径（/path/to/postman-api-server/build/index.js）并重启客户端以刷新工具定义缓存，属于手动、易出错的流程；由于是静态审查且缺乏 CI/测试验证安装可用性，按规定上限为 15 分，综合评为 12 分。

静态评测 · 未实际运行收录于 2026-09-07

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络修改第三方账户数据

适合谁

需要在 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 通信，调试相对困难

安装接入

准备工作

运行环境：Node.js

POSTMAN_API_KEY 必填密钥 Postman API 密钥，用于访问你的 Postman 资源；在 Postman 账户设置（go.postman.co/settings/me/api-keys）中生成，只显示一次。

安装 Node.js
克隆仓库并进入目录
运行 pnpm install 安装依赖
运行 pnpm run build 构建
在 Postman 账户设置中生成 API Key 并配置为 POSTMAN_API_KEY 环境变量
在 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"}}}}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "postman": {
      "command": "node",
      "args": [
        "/path/to/postman-api-server/build/index.js"
      ],
      "env": {
        "POSTMAN_API_KEY": "CHANGEME"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add postman -e POSTMAN_API_KEY=CHANGEME -- node /path/to/postman-api-server/build/index.js

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在 Claude Desktop 或 Cline 中连接该服务器后，运行一个简单查询（如列出工作区）；若能返回你的 Postman 工作区，说明 POSTMAN_API_KEY 配置成功且连接正常。也可通过 `pnpm run inspector` 启动 MCP Inspector，在 Tools 页面确认工具已加载。

常见排障

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

试试这样问

连接成功后，可以直接对 AI 助手这样说：

列出我在 Postman 的所有工作区。
获取我的 Postman 集合列表，并显示每个集合中包含多少个请求。
创建一个名为 staging-test 的新 Postman 环境。
为集合 foo 添加一条评论。

使用场景

管理多个 Postman 集合与文件夹

通过 AI 自动化测试与文档维护

协调多环境管理与配置

对错误敏感的 API 测试与合规检查

支持客户端

Claude Desktop

Cline

Zed部分支持

依据项目文档列出，未经本站实测。

详细介绍

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