Postman MCP 生成器
欢迎来到您生成的MCP服务器！🚀 这个项目是使用 Postman MCP 生成器，配置为 模型上下文提供者（MCP） 服务器输出模式。它为您提供：
- ✅ 一个兼容MCP的服务器（
mcpServer.js） - ✅ 为每个选定的Postman API请求自动生成JavaScript工具
我们来安排一下吧！
🚦 开始使用
⚙️ 先决条件
在开始之前，请确保您已准备好：
- （随Node附带）
警告：如果您使用的是较低版本的 Node， fetch 不会在场。工具使用 fetch 进行HTTP调用。为了解决这个问题，你可以修改工具以使用 node-fetch 相反，要确保 node-fetch 作为依赖项安装，然后将其导入为 fetch 写入到每个工具文件中。
📥 安装与设置
1. 安装依赖项
在你的项目根目录下运行：
npm install🔐 设置工具环境变量
在 .env 在文件中，你会看到环境变量占位符，每个占位符对应一个所选工具的来源工作区。例如，如果你从两个工作区（如Acme和Widgets）中选择了requests工具，那么你会看到两个占位符：
ACME_API_KEY=
WIDGETS_API_KEY=将每个API的实际API密钥更新到值中。这些环境变量在生成的工具内部用于为每个请求设置API密钥。您可以检查文件中的 tools 查看目录以了解其工作原理。
// environment variables are used inside of each tool file
const apiKey = process.env.ACME_API_KEY;注意事项： 这可能并不适用于每个API。生成逻辑相对简单——对于每个工作区，我们创建一个与工作区标识符同名的环境变量，然后在属于该工作区的每个工具文件中使用该环境变量。如果这不符合您所选API的行为，没问题！您可以手动更新其中的任何内容 .env 文件或工具文件需准确反映API的认证方式。
🌐 使用Postman测试MCP服务器
MCP服务器（mcpServer.js) 将您的自动化API工具暴露给MCP兼容的客户端，如Claude桌面版或Postman桌面应用程序。我们建议您先使用Postman测试服务器，然后再将其用于与大型语言模型（LLM）一起使用。
邮递员桌面应用程序是运行和测试MCP服务器最简便的方式。首先测试下载的服务器是可选的，但建议这么做。
第一步从（指定网站）下载最新的Postman桌面应用程序 。
第二步朗读文档文章 这里 并了解如何在Postman应用中创建一个MCP请求。
第三步将MCP请求的类型设置为 STDIO 并将命令设置为 node 如果你在仅使用（某功能/服务）时遇到问题 node （例如，如果使用的是旧版本），请为 Node.js 18+ 版本提供一个绝对路径。您可以通过运行以下命令来获取 Node.js 的完整路径：
which node要检查节点版本，请运行：
node --version获取到绝对路径 mcpServer.js，运行：
realpath mcpServer.js使用 node 命令，后接完整路径 mcpServer.js 作为您新的Postman MCP请求的命令。然后点击 连接 按钮。你应该会看到一个工具列表，这些工具是你在生成服务器之前选择的。你可以在将MCP服务器连接到大型语言模型（LLM）之前，先在这里测试每个工具是否正常工作。
👩💻 将MCP服务器连接到Claude
您可以将您的MCP服务器连接到任何MCP客户端。在此，我们提供将MCP服务器连接到Claude Desktop的说明。
第一步注意节点的完整路径以及 mcpServer.js 来自上一步。
第二步打开Claude桌面版→ 设置 → 开发者 → 编辑配置 并添加一个新的MCP服务器：
{
"mcpServers": {
"": {
"command": "",
"args": [""]
}
}
}重启 Claude Desktop 以激活此更改。确保新的 MCP 已开启，并且其旁边有一个绿色圆圈。如果满足这些条件，您就可以开始使用已连接工具的聊天会话了。
警告如果你没有提供一个到（文件/目录）的绝对路径 node 版本为v18+时，Claude（以及其他MCP客户端）可能会回退到另一个（版本/方案） node 在先前版本的系统上运行的版本。在这种情况下 fetch API将不存在，工具调用也将无法工作。如果发生这种情况，您可以：a) 安装较新版本的node，并在命令中指向它，或 b) 导入 node-fetch 作为每个工具的 fetch，同时确保也添加了 node-fetch 在你的 package.json 中添加依赖。
附加选项
🐳 Docker 部署（生产环境）
对于生产环境部署，您可以使用 Docker：
1. 构建Docker镜像
docker build -t .2. Claude 桌面集成
在Claude Desktop中添加Docker服务器配置（设置 → 开发人员 → 编辑配置）：
{
"mcpServers": {
"": {
"command": "docker",
"args": ["run", "-i", "--rm", "--env-file=.env", ""]
}
}
}在内部添加您的环境变量（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"]🌐 可流式传输的HTTP
要运行支持Streamable HTTP的服务器，请使用 --streamable-http 标志。这启动了服务器并 /mcp 端点已启用：
node mcpServer.js --streamable-http🌐 服务器发送事件 (SSE)
要运行支持服务器发送事件（SSE）的服务器，请使用 --sse 标志。这将启动带有（特定配置或参数的）服务器 /sse 并且 /messages 已启用的端点：
node mcpServer.js --sse🖥️ Stdio（标准输入/输出）
要使用标准输入/输出（stdio）运行服务器，只需直接运行脚本而无需任何标志。此模式非常适合通过标准输入和标准输出进行命令行界面（CLI）工具操作或程序化集成。
node mcpServer.js🛠️ 额外的命令行界面（CLI）命令
列出工具
列出所有生成工具的描述和参数：
node index.js tools示例：
Available Tools:
Workspace: acme-workspace
Collection: useful-api
list_all_customers
Description: Retrieve a list of useful things.
Parameters:
- magic: The required magic power
- limit: Number of results returned
[...additional parameters...]添加新工具
轻松扩展您的MCP服务器，添加更多工具：
- 参观 Postman MCP 生成器。
- 选择新的API请求，生成一个新的MCP服务器，并下载它。
- 将新生成的工具复制到您的现有项目中
tools/文件夹。 - 更新你的
tools/paths.js文件中包含新的工具引用。
💬 问题与支持
参观 Postman MCP 生成器 用于查看更新和新功能的页面。
加入 #mcp-lab 频道中的 Postman Discord（直译为“邮递员迪斯科德”，但通常可保持原样或根据上下文意译为“Postman在Discord上”或“Postman的Discord频道/服务器”等，具体翻译需结合语境） 分享你的成果并寻求帮助。