Postman工具生成服务

一个将Postman集合和请求转换为类型安全代码的AI代理工具生成服务,支持多种AI框架。

  • by giovannicocco
  • JavaScript
  • 本地部署
  • 13 星标
  • 更新于
在 GitHub 查看 giovannicocco/mcp-server-postman-tool-generation

使用说明

邮递员工具生成MCP服务器

一个MCP服务器,从Postman收集和请求中生成AI代理工具。该服务器与Postman API集成,将API端点转换为可用于各种人工智能框架的类型安全代码。

模型上下文协议(MCP)是一种 新的标准化协议 用于管理大型语言模型(LLM)和外部系统之间的上下文。在这个存储库中,我们提供了一个安装程序以及一个MCP服务器 邮差工具生成API.

这使您可以使用 克劳德桌面,或任何类似MCP客户端 克莱恩,使用自然语言在您的Postman帐户上完成任务,例如:

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

特性

  • 从Postman集合生成Types/JavaScript代码
  • 支持多种AI框架(OpenAI、Mistral、Gemini、Anthropic、LangChain、AutoGen)
  • 类型安全代码生成
  • 错误处理和响应验证

演示

设置

  1. 安装依赖项:
npm install
  1. 构建服务器:
npm run build
  1. 通过在Claude设置文件中添加以下内容来配置MCP设置(cline_mcp_settings.json):
{
  "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
  1. 对以下内容进行更改 src/index.ts

  2. 构建服务器:

npm run build
  1. 重新启动Claude应用程序以加载更新的服务器

环境变量

  • POSTMAN_API_KEY:您的邮差API密钥(必需)

错误处理

该服务器包括全面的错误处理功能,用于:

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

错误响应包括帮助诊断问题的详细消息。

贡献

欢迎投稿!请随时提交拉取请求。

许可证

MIT许可证