Postman Tool Generation MCP Server

Postman 工具生成 MCP 服务

一个可根据 Postman 集合和请求生成 AI Agent 工具的 MCP 服务。此服务与 Postman API 集成，可将 API 端点转换为类型安全的代码，供各种 AI 框架使用。

模型上下文协议（MCP）是一种用于管理大模型（LLM）与外部系统之间上下文的新型标准化协议。在此代码库中，我们提供一个安装程序，以及一个用于 Postman 工具生成 API 的 MCP 服务。

这样一来，你就可以使用 Claude Desktop 或任何 MCP 客户端（例如 Cline），通过自然语言在 Postman 账户中完成操作，例如：

• Create an AI tool for: collectionID: 12345-abcde requestID: 67890-fghij typescript openai

功能

• 根据 Postman 集合生成 TypeScript/JavaScript 代码
• 支持多种 AI 框架（OpenAI、Mistral、Gemini、Anthropic、LangChain、AutoGen）
• 类型安全的代码生成
• 错误处理和响应验证

演示

设置

1. 安装依赖：

npm install

2. 构建服务：

npm run build

3. 将以下内容添加到 Claude 设置文件（cline_mcp_settings.json）中，以配置 MCP 设置：

{
  "mcpServers": {
    "postman-ai-tools": {
      "command": "node",
      "args": [
        "/path/to/postman-tool-generation-server/build/index.js"
      ],
      "env": {
        "POSTMAN_API_KEY": "your-postman-api-key"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

用法

此服务提供一个名为 generate_ai_tool 的工具，参数如下：

{
  collectionId: string;    // The Public API Network collection ID
  requestId: string;       // The public request ID
  language: "javascript" | "typescript";  // Programming language to use
  agentFramework: "openai" | "mistral" | "gemini" | "anthropic" | "langchain" | "autogen";  // AI framework
}

示例

// Using the tool through MCP
const result = await use_mcp_tool({
  server_name: "postman-ai-tools",
  tool_name: "generate_ai_tool",
  arguments: {
    collectionId: "your-collection-id",
    requestId: "your-request-id",
    language: "typescript",
    agentFramework: "openai"
  }
});

生成的代码

此工具会生成类型安全的代码，其中包含：

• 请求/响应的类型定义
• 错误处理
• API 集成
• OpenAI 函数定义
• 文档和示例

开发

1. 安装依赖：

npm install

2. 修改 src/index.ts

3. 构建服务：

npm run build

4. 重启 Claude 应用以加载更新后的服务

环境变量

• POSTMAN_API_KEY：你的 Postman API 密钥（必需）

错误处理

此服务包含完善的错误处理机制，可处理：

• 无效参数
• API 故障
• JSON 解析错误
• 网络问题

错误响应包含详细信息，可帮助诊断问题。

贡献

欢迎贡献！欢迎提交 Pull Request。

许可证

MIT 许可证