Postman MCP Generator

欢迎来到您的生成的MCP服务器！🚀 此项目使用Postman MCP Generator创建，并配置为Model Context Provider (MCP)服务器输出模式。它为您提供：

• ✅ 一个兼容MCP的服务器（mcpServer.js）
• ✅ 自动为每个选定的Postman API请求生成的JavaScript工具

让我们开始设置吧！

🚦 快速入门

⚙️ 先决条件

在开始之前，请确保您拥有：

• Node.js（需要v18+，推荐v20+）
• npm（随Node一起提供）

警告：如果您使用的是较低版本的Node，fetch可能不存在。工具使用fetch来发起HTTP调用。要解决这个问题，您可以修改工具以使用node-fetch。确保已将node-fetch安装为依赖项，并在每个工具文件中将其导入为fetch。

📥 安装与设置

1. 安装依赖项

从项目的根目录运行：

npm install

🔐 设置工具环境变量

在.env文件中，您会看到环境变量占位符，每个占位符对应于所选工具所在的每个工作区。例如，如果您选择了来自两个工作区（如Acme和Widgets）的请求，您会看到两个占位符：

ACME_API_KEY=
WIDGETS_API_KEY=

使用实际的API密钥更新这些值。这些环境变量用于生成的工具中，以设置每个请求的API密钥。您可以在tools目录中的文件中查看其工作原理。

// 环境变量在每个工具文件中使用
const apiKey = process.env.ACME_API_KEY;

注意事项：这可能不适用于每个API。生成逻辑相对简单——对于每个工作区，我们创建一个与工作区slug同名的环境变量，然后在属于该工作区的每个工具文件中使用该环境变量。如果这不是您选择的API的行为，则没有问题！您可以手动更新.env文件或工具文件，以准确反映API的身份验证方法。

🌐 使用Postman测试MCP服务器

MCP服务器（mcpServer.js）向兼容MCP的客户端（如Claude Desktop或Postman Desktop应用程序）公开您的自动化API工具。我们建议您首先使用Postman测试服务器，然后再将其与LLM一起使用。

Postman Desktop应用程序是运行和测试MCP服务器最简单的方法。先测试下载的服务器是可选但推荐的步骤。

步骤1：从https://www.postman.com/downloads/下载最新版的Postman Desktop应用程序。

步骤2：阅读此处的文档文章，了解如何在Postman应用程序中创建MCP请求。

步骤3：将MCP请求类型设置为STDIO，并将命令设置为node </绝对路径到/mcpServer.js>。如果您遇到仅使用node的问题（例如使用了旧版本），请提供指向版本18+的绝对路径。您可以通过运行以下命令获取node的完整路径：

which node

检查node版本，运行：

node --version

获取mcpServer.js的绝对路径，运行：

realpath mcpServer.js

使用node命令加上mcpServer.js的完整路径作为您新Postman MCP请求的命令。然后点击连接按钮。您应该能看到之前生成服务器时选择的工具列表。您可以在连接MCP服务器到LLM之前在这里测试每个工具是否正常工作。

👩‍💻 将MCP服务器连接到Claude

您可以将您的MCP服务器连接到任何MCP客户端。这里提供了将其连接到Claude Desktop的说明。

步骤1：记下上一步中的node和mcpServer.js的完整路径。

步骤2. 打开Claude Desktop → 设置 → 开发者 → 编辑配置 并添加一个新的MCP服务器：

{
  "mcpServers": {
    "<server_name>": {
      "command": "<绝对路径到/node>",
      "args": ["<绝对路径到/mcpServer.js>"]
    }
  }
}

重启Claude Desktop以激活此更改。确保新的MCP已开启并旁边有一个绿色圆圈。如果是这样，您就可以开始聊天会话，使用已连接的工具了。

警告：如果您没有提供指向版本18+的node的绝对路径，Claude（和其他MCP客户端）可能会回退到系统上的另一个较早版本的node。在这种情况下，fetch API将不存在，工具调用将不起作用。如果发生这种情况，您可以a) 安装一个更新版本的node并在命令中指向它，或者b) 在每个工具中导入node-fetch作为fetch，并确保也将node-fetch依赖项添加到您的package.json中。

额外选项

🐳 Docker部署（生产）

对于生产部署，您可以使用Docker：

1. 构建Docker镜像

docker build -t <your_server_name> .

2. Claude Desktop集成

在Claude Desktop中添加Docker服务器配置（设置 → 开发者 → 编辑配置）：

{
  "mcpServers": {
    "<your_server_name>": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "--env-file=.env", "<your_server_name>"]
    }
  }
}

将您的环境变量（API密钥等）添加到.env文件中。

该项目附带了以下最小Docker设置：

FROM node:22.12-alpine AS builder

WORKDIR /app
COPY package.json package-lock.json ./
RUN npm install

COPY . .

ENTRYPOINT ["node", "mcpServer.js"]

🌐 服务器发送事件（SSE）

要启用服务器发送事件（SSE）支持运行服务器，请使用--sse标志：

node mcpServer.js --sse

🛠️ 额外CLI命令

列出工具

列出所有生成工具的描述和参数：

node index.js tools

示例：

可用工具：

工作区：acme-workspace
  集合：useful-api
    list_all_customers
      描述：检索有用的事项列表。
      参数：
        - magic: 所需的魔法力量
        - limit: 返回的结果数量
        [...其他参数...]

➕ 添加新工具

轻松扩展您的MCP服务器：

1. 访问Postman MCP Generator。
2. 选择新的API请求，生成新的MCP服务器并下载。
3. 将新生成的工具复制到现有项目的tools/文件夹中。
4. 更新您的tools/paths.js文件以包含新的工具引用。

💬 问题和支持

访问Postman MCP Generator页面获取更新和新功能。

加入Postman Discord中的#mcp-lab频道，分享您的成果并获得帮助。