邮递员MCP生成器
欢迎使用您生成的MCP服务器！ 🚀 此项目是使用创建的 邮递员MCP生成器，配置为 模型上下文提供程序（MCP） 服务器输出模式。它为您提供：
- ✅ MCP兼容服务器(
mcpServer.js) - ✅ 为每个选定的Postman API请求自动生成JavaScript工具
让我们把事情安排好！
🚦 入门指南
⚙️ 先决条件
在开始之前，请确保您已经：
- （包含在Node中）
警告：如果您使用较低版本的Node运行， fetch 不会出席。工具使用 fetch 进行HTTP调用。为了解决这个问题，您可以修改要使用的工具 node-fetch 相反。确保 node-fetch 作为依赖项安装，然后将其导入为 fetch 在每个工具文件中。
📥 安装和设置
安装依赖项
从项目的根目录运行：
npm install🔐 设置工具环境变量
在 .env 在文件中，您将看到环境变量占位符，每个占位符对应所选工具所在的工作区。例如，如果您从2个工作区（例如Acme和Widgets）中选择请求，您将看到两个占位符：
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都正确。生成逻辑相对简单——对于每个工作区，我们创建一个与工作区slug同名的环境变量，然后在属于该工作区的每个工具文件中使用该环境变量。如果这不是您选择的API的正确行为，没问题！您可以手动更新 .env 文件或工具文件，以准确反映API的身份验证方法。
🌐 使用Postman测试MCP服务器
MCP服务器(mcpServer.js)向兼容MCP的客户端（如Claude Desktop或Postman Desktop应用程序）公开您的自动化API工具。我们建议您先使用Postman测试服务器，然后再使用LLM。
Postman桌面应用程序是运行和测试MCP服务器的最简单方法。首先测试下载的服务器是可选的，但建议这样做。
步骤1：从下载最新的Postman桌面应用程序 .
步骤2：阅读 MCP要求提供文件 并了解如何在Postman应用程序中创建MCP请求。
步骤3：将MCP请求的类型设置为 STDIO 并将命令设置为 node 。如果您对仅使用有问题 node （例如使用旧版本）提供到节点版本18+的绝对路径。您可以通过运行以下命令来获取节点的完整路径：
which node要检查节点版本，请运行：
node --version获取到的绝对路径 mcpServer.js，运行：
realpath mcpServer.js使用node命令后跟完整路径 mcpServer.js 作为新Postman MCP请求的命令。然后单击 连接 按钮。您应该看到在生成服务器之前选择的工具列表。在将MCP服务器连接到LLM之前，您可以在这里测试每个工具是否正常工作。
👩💻 将MCP服务器连接到Claude
您可以将MCP服务器连接到任何MCP客户端。在这里，我们提供了将其连接到Claude Desktop的说明。
步骤1：注意节点的完整路径和 mcpServer.js 从上一步开始。
步骤2.打开克劳德桌面→ 设置 → 开发者 → 编辑配置 并添加新的MCP服务器：
{
"mcpServers": {
"": {
"command": "",
"args": [""]
}
}
}重新启动Claude Desktop以激活此更改。确保新的MCP已打开，并且旁边有一个绿色圆圈。如果是这样，您就可以开始使用您连接的工具的聊天会话了。
警告：如果你没有提供一个绝对的路径 node 如果版本是v18+，Claude（和其他MCP客户端）可能会回退到另一个版本 node 系统上以前版本的版本。在这种情况下 fetch API将不存在，工具调用将不起作用。如果发生这种情况，您可以a）安装新版本的节点并在命令中指向它，或者b）导入 node-fetch 进入每个工具 fetch，确保还添加 node-fetch 依赖于你的package.json。
附加选项
🐳 Docker部署（生产）
对于生产部署，您可以使用Docker：
构建Docker镜像
docker build -t .Claude桌面集成
将Docker服务器配置添加到Claude Desktop（设置→ 开发者→ 编辑配置）：
{
"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）运行服务器，只需运行不带任何标志的脚本。此模式非常适合CLI工具或通过stdin和stdout进行编程集成。
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服务器：
- 访问 邮递员MCP生成器.
- 选择新的API请求，生成新的MCP服务器并下载。
- 将新生成的工具复制到现有项目的
tools/文件夹。 - 更新您的
tools/paths.js文件中包含新的工具参考。
💬 问题与支持
访问 邮递员MCP生成器 更新和新功能页面。
加入 #mcp-lab 频道在 邮递员不和谐 分享你所建立的东西并获得帮助。
🤖 GitHub Copilot聊天集成
此MCP服务器还配置了GitHub Copilot Chat集成，允许您直接在GitHub Copilot-Chat中使用所有7个Primavera数据服务工具。
GitHub Copilot聊天的快速设置
- 复制扩展配置:
npm run copilot:install- 测试连接:
npm run copilot:validate- 在GitHub Copilot聊天中尝试:
npm run copilot:test在Copilot聊天中使用Primavera工具
配置后，您可以使用以下命令：
@primavera-data-service sync-metadata-同步数据库元数据@primavera-data-service query-tables-data-对Primavera数据执行SQL查询@primavera-data-service get-tables-metadata-获取可用的表格信息
生产服务器
服务器部署并运行在：
- 健康:
- MCP端点:
有关完整的GitHub Copilot Chat集成文档，请参阅 .