邮递员-MCP服务器

Name: 邮递员-MCP服务器
Author: delano

作者：delano143 星标更新：2025-09-13

安装使用来源：spider==github.com

项目介绍

Postman MCP 服务器

版本: v0.2.0

一个提供访问 Postman API 的 MCP 服务器。功能基于官方 OpenAPI 规范。更多详情，请参阅 Postman API 文档。

该项目是 Anthropic 的 Model Context Protocol (MCP) 计划的一部分。更多信息，请访问 MCP GitHub 仓库和 Anthropic 博客上的公告。

跳转到安装说明

postman-mcp-server - 封面图片

[!WARNING] 本项目目前处于积极开发中。请谨慎使用并预期会有重大变更。

[!NOTE] 由 AI 生成的代码。我使用了 Cline v2.2.2 和 Claude 3.5 Sonnet (2024-10-22)。有关如何生成此代码的提示和详细信息，请参阅 docs/README.md。

概述
特性
- 集合
- 环境
- API
- 认证与授权
- 其他特性
安装
- 前置条件
- 步骤
使用
文档
- 项目概述
理由
开发
调试
其他 MCP 服务器
许可证

概述

Postman MCP 服务器是一个基于 TypeScript 的 MCP 服务器，它与 Postman API 集成，提供了对 Postman 集合、环境和 API 的全面管理。

特性

集合

CRUD 操作: 创建、检索、更新和删除 Postman 集合。
文件夹管理: 在集合内组织请求到文件夹中。
请求管理: 在集合内添加、更新和删除请求。
响应管理: 管理与请求关联的响应。
版本控制: 分叉、合并和拉取集合更改。
评论: 添加和管理集合上的评论。

环境

管理环境: 为不同的设置创建和检索环境。
CRUD 操作: 完全支持创建、更新和删除环境。

API

API 管理: 创建、检索、更新和删除 API。
模式支持: 管理具有多文件支持的 API 模式。
标签: 添加和管理 API 标签。
评论: 添加和管理 API 上的评论。

认证与授权

API 密钥认证: 使用 API 密钥进行安全访问。
基于角色的访问控制: 在工作区和集合级别管理权限。
工作区权限: 定义特定于工作区的权限。

其他特性

私有 API 网络: 管理私有 API 网络中的元素和文件夹。
Webhook: 创建 webhook 以触发带有自定义负载的集合。
企业特性: 为企业环境提供高级角色控制和 SCIM 支持。

安装

通过 Smithery 安装

要通过 Smithery 自动安装 Postman MCP 服务器到 Claude Desktop：

npx -y @smithery/cli install postman-api-server --client claude

前置条件

已安装 Node.js。

步骤

克隆仓库:

git clone https://github.com/delano/postman-api-server.git
cd postman-api-server

安装依赖项:
```
pnpm install
```
构建服务器:
```
pnpm run build
```
在开发模式下运行并自动重建:
```
pnpm run watch
```

使用

设置 API 密钥

生成你的 API 密钥
- 访问 Postman 账户设置
- 点击“生成 API 密钥”
- 安全保存密钥 - 它不会再次显示
配置 API 密钥
- 将密钥添加到你的环境中作为 POSTMAN_API_KEY
- 对于 Claude Desktop 或 Cline，在配置文件中包括它（参见下面的配置示例）
- 不要在版本控制系统中提交 API 密钥
验证访问
- API 密钥提供了对你有权访问的所有 Postman 资源的访问
- 通过运行简单的查询（例如，列出工作区）来测试访问

[!NOTE] 如果你直接使用 Postman API 集合，请将你的 API 密钥存储为 postman-api-key 集合变量。

使用 Claude Desktop

要与 Claude Desktop 一起使用，添加服务器配置：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json

[!IMPORTANT] 如果你在更新此提供程序时，Claude 必须重新启动以从输入模式中获取 API 更改（即当 MCP 服务器的 ToolDefinition 元素发生变化时）。这是因为 Claude 在启动时缓存了工具定义。

示例配置

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

使用 Cline

使用相同的示例配置，将服务器配置添加到你的 Cline MCP 服务器配置中：

示例配置

与上面的 Claude 相同。

使用 Zed

我仍在尝试使其正常工作。根据 Zed 文档，它需要成为一个扩展（也参见此问题 #21455）。

文档

官方 Postman API 文档可在 Postman 公共工作区中找到。

项目概述

Postman API 参考与总结

本项目利用 Claude 模型和 Cline 扩展将 OpenAPI 规范转换为 TypeScript 代码，增强类型安全性并在 MCP 服务器中实现集成。

此 GitHub 项目包括 API 参考文档，提供了详细的指导，用于编程方式使用 Postman 平台。它涵盖了本地开发的 Collection SDK 和云平台集成的 Postman API。关键主题包括身份验证机制、速率限制以及所有 API 端点的深入文档，包括工作区、集合、环境、模拟服务器、监控器等。此外，指南还提供了先决条件和快速入门说明，以便无缝地进行 API 交互。

docs/api/summaries 目录包含了 Postman API 的全面 Markdown 总结。这些文档概述了 API 端点、请求/响应格式以及实现细节，对于验证和确保 MCP 服务器的功能至关重要。参阅 API 总结 README 以了解文档结构和实现策略的概述。

将 OpenAPI 规范转换为 TypeScript 代码

构建 MCP 服务器

参阅处理程序文档，详细了解实现 MCP 服务器处理程序的具体规范。这包括 URI 格式、提示要求和资源处理模式。这对于正在整合和增强 MCP 服务器中 Postman API 功能的开发者来说至关重要。

理由

Postman 工具的 MCP 包装器主要作为复杂、多步骤操作的 AI 交互层，其中结构和安全性至关重要。然而，对于简单操作，直接使用 CLI 或 API 就足够了。MCP 包装器在以下情况下提供最大价值：

复杂操作

管理多个集合
协调环境
生成综合报告

AI 驱动自动化

自动化测试工作流
API 文档维护
环境管理

错误敏感操作

关键 API 测试
生产部署
合规检查

对于以下情况，它提供的价值较小：

简单操作

基本集合运行
单个 API 调用
快速环境检查

直接 CLI 使用

开发者驱动的操作
本地测试
快速迭代

开发

安装依赖项：

pnpm install

构建服务器：

pnpm run build

开发模式下自动重建：

pnpm run watch

调试

由于 MCP 服务器通过 stdio 进行通信，调试可能会很困难。我们推荐使用 MCP Inspector，它作为一个包脚本可用：

pnpm run inspector

文档

Inspector 将提供一个 URL 来访问浏览器中的调试工具：http://localhost:5173。你需要在连接之前添加 POSTMAN_API_KEY。导航到“工具”开始。

其他 MCP 服务器

许可证

本项目采用 MIT 许可证。详情请参阅 LICENSE 文件。