Postman API

官方

一个用于与Postman API交互的MCP服务器，需要API密钥。

GitHub
317
试用此 MCP赞助

你可以用 Postman API MCP 做什么？

  • 管理集合 — 让您的助手直接在编辑器中创建、标记或更新 Postman 集合及其文档。
  • 生成客户端代码 — 根据您的 API 定义，请求生成生产就绪的客户端代码，遵循最佳实践和项目约定。
  • 从代码创建规范 — 让您的助手从代码库生成 API 规范，并将其转换为 Postman 集合。
  • 管理环境 — 指示您的助手创建工作区和环境，并在不离开 IDE 的情况下管理环境变量。
  • 运行 API 测试 — 使用本地服务器持续测试您的 API 与 Postman 集合的兼容性，包括本地端点。

托管 MCP 服务器

npx add-mcp 'https://mcp.postman.com/minimal'

可安装到 Claude Code、Codex、Cursor 等客户端

文档

Postman MCP 服务器

Postman MCP 服务器实现了模型上下文协议（MCP），将 AI 代理和编码助手（包括 Claude Code、Cursor、VS Code Copilot、GitHub Copilot CLI 和 Gemini CLI）直接连接到您的 Postman 工作区、集合、规范和环境中。

Postman 还以 npm 包的形式提供该服务器。

有关包含特定代理设置的完整安装指南，请参阅 Postman 的 MCP 服务器产品页面。

Postman MCP 服务器集合

Postman MCP 服务器集合是探索、测试和连接到 Postman MCP 服务器的最快捷方式。您可以使用它来：

工具配置

  • 最小版 —（默认）仅包含用于基本 Postman 操作的必要工具。适合想要修改单个 Postman 元素（如集合、工作区或环境）的用户。
  • 代码版 — 包含从公共和内部 API 定义生成高质量、组织良好的客户端代码的工具。适合需要消费 API 或将 API 上下文提供给代理的用户。
  • 完整版 — 包含所有可用的 Postman API 工具（100+ 个工具）。适合参与高级协作和使用 Postman 企业功能的用户。
  • 学习版 — 在 Postman 文档中搜索指南、教程和参考内容。适合需要发现 Postman 功能、查找 API 概念或寻找学习资源的代理。

身份验证

为了获得最佳的开发者体验和最快速的设置，请在远程服务器上使用 OAuth（https://mcp.postman.com）。OAuth 完全符合 MCP 授权规范，无需手动配置 API 密钥。

欧盟远程服务器和本地服务器仅支持 Postman API 密钥身份验证。

快速开始

远程（任何兼容 OAuth 的 MCP 主机）：

将此 URL 添加到您的 MCP 主机配置中：

https://mcp.postman.com/minimal

将 /minimal 更改为 /code 或 /mcp 以切换到代码版或完整版模式。对于欧盟或 API 密钥身份验证，请将 Authorization: Bearer <POSTMAN_API_KEY> 作为标头传递。

本地：

npx @postman/postman-mcp-server

添加 --code 或 --full 以切换到代码版或完整版模式。将 POSTMAN_API_KEY 设置为环境变量。

有关特定 IDE 的设置说明，请参阅下表。有关更多信息，请参阅 Postman MCP 服务器文档。

支持的代理和 IDE

代理 / IDE远程本地
Claude Code文档文档
Claude Desktop文档文档
Cursor文档文档
VS Code文档文档
Codex文档文档
Antigravity CLI文档文档
GitHub Copilot CLI文档文档
Kiro文档文档
Docker—文档

欧盟支持

Postman MCP 服务器支持远程和本地服务器的欧盟区域：

  • 对于流式 HTTP，远程服务器可在 https://mcp.eu.postman.com/mcp（完整版）、https://mcp.eu.postman.com/code 和 https://mcp.eu.postman.com/minimal 上使用。
  • 对于 STDIO 公共包，请使用 --region eu 标志，或直接设置 POSTMAN_API_BASE_URL 环境变量。
  • 欧盟服务器不支持 OAuth。欧盟远程服务器仅支持 API 密钥身份验证。

使用场景

  • API 测试 — 使用您的 Postman 集合持续测试您的 API。使用本地服务器测试本地 API，因为远程服务器无法访问您的工作站网络。
  • 代码同步 — 保持您的代码与 Postman 集合和规范同步。
  • 集合管理 — 创建和标记集合、更新文档、添加评论，或在不离开编辑器的情况下对多个集合执行操作。
  • 工作区和环境管理 — 创建工作区和环境，并管理环境变量。
  • 自动规范创建 — 从您的代码创建规范，并使用它们生成集合。
  • 客户端代码生成 — 生成遵循最佳实践和项目约定的生产就绪客户端代码，用于消费 API。

Docker

有关 Docker 设置和安装，请参阅 DOCKER.md。

贡献

欢迎提交错误报告、工具请求和文档修复 — 请参阅 CONTRIBUTING.md。

此处的 MCP 工具定义和服务器实现是从 Postman 的内部真实来源同步的，因此对 src/ 下文件的更改无法在此仓库中合并 — 但问题正是这些更改得以实现的方式，我们会对已发布的贡献予以致谢。文档和仓库工具直接接受拉取请求。

发现安全问题？请参阅 SECURITY.md — 请不要公开提交问题。

问题和支持

关键词

模型上下文协议 · MCP 服务器 · Postman · AI 代理 · Claude Code · Cursor · VS Code · 规范 · REST API · API 测试 · TypeScript · OpenAPI