你是否曾经希望根据Postman集合自动生成AI代理工具代码,而无需手动编写API集成?今天要介绍的开源项目Postman AI工具生成器,正是为了实现这个目标而设计的。它是一个MCP服务器,可以从Postman集合和请求生成AI代理工具,将API端点转换为类型安全的代码。

项目基本信息

信息项详情
项目名称Postman AI工具生成器
GitHub地址https://github.com/giovannicocco/postman-tool-generation-mcp-server
项目描述一个MCP服务器,可以从Postman集合和请求生成AI代理工具。该服务器与Postman API集成,将API端点转换为类型安全的代码。
作者giovannicocco
开源协议MIT License
开源状态公开状态
LanguagesTypeScript
支持平台Windows / macOS / Linux
最后更新2026-04-24

一、项目介绍

Postman AI工具生成器是一个让AI能够从Postman集合生成代理工具代码的MCP服务器。它支持多种AI框架,生成类型安全的代码,包含错误处理和响应验证。

这个服务器提供了一个核心工具:

  • generate_ai_tool:从Postman集合生成AI工具代码

二、核心优势

自动代码生成

从Postman集合自动生成API集成代码。

多框架支持

支持OpenAI、Mistral、Gemini、Anthropic、LangChain、AutoGen。

类型安全

生成TypeScript/JavaScript类型定义。

完整集成

包含请求/响应类型、错误处理、函数定义。

MIT许可证

可自由使用和修改。

三、适用场景

API快速集成

快速将Postman中的API转换为AI可调用的工具。

AI代理开发

为AI代理生成类型安全的API调用代码。

代码标准化

统一API集成代码的风格和结构。

多框架适配

为不同AI框架生成适配代码。

四、安装教程

系统要求

工具用途下载/安装方式
Node.js运行环境[https://nodejs.org/] (版本要求:18.0 或更高)
Postman API密钥访问Postman[https://postman.com]

安装步骤

第一步:获取Postman API密钥

  1. 登录Postman
  2. 进入API Keys设置
  3. 生成API密钥

第二步:克隆项目并安装

git clone https://github.com/giovannicocco/postman-tool-generation-mcp-server.git
cd postman-tool-generation-mcp-server
npm install
npm run build

第三步:配置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"
      }
    }
  }
}

五、使用示例

示例1:生成TypeScript工具(OpenAI)

{
  "collectionId": "your-collection-id",
  "requestId": "your-request-id",
  "language": "typescript",
  "agentFramework": "openai"
}

示例2:生成JavaScript工具(Anthropic)

{
  "collectionId": "your-collection-id",
  "requestId": "your-request-id",
  "language": "javascript",
  "agentFramework": "anthropic"
}

示例3:生成的代码包含

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

六、支持的AI框架

  • openai:OpenAI框架
  • mistral:Mistral框架
  • gemini:Google Gemini框架
  • anthropic:Anthropic Claude框架
  • langchain:LangChain框架
  • autogen:微软AutoGen框架

七、常见问题

问题1:API密钥无效

解决方案:检查Postman API密钥是否正确。

问题2:collectionId无效

解决方案:确认collection ID正确且有访问权限。

问题3:生成代码不完整

解决方案:检查Postman请求定义是否完整。

问题4:Node.js版本

解决方案:需要Node.js 18或更高版本。

问题5:框架版本兼容

解决方案:生成代码针对特定框架版本,可能需要调整。

八、总结

Postman AI工具生成器是一个让AI能够从Postman集合自动生成API集成代码的MCP服务器,支持多种AI框架。

这个项目的最大价值在于:

  1. 自动生成:从Postman到AI工具
  2. 多框架:6种主流框架
  3. 类型安全:TypeScript支持
  4. 完整代码:错误处理+函数定义
  5. MIT许可证:可自由使用

如果你需要使用Postman API集成AI代理,Postman AI工具生成器是一个非常实用的工具。

标签: 开发者工具

已有 34 条评论

    1. EliElse EliElse

      总的来说,这是Postman集成的最佳MCP工具。

    2. FayFetch FayFetch

      看完教程立刻去配置了,第一个工具生成成功了。

    3. GavinGrep GavinGrep

      感谢作者giovannicocco的开源贡献。

    4. HollyHash HollyHash

      期待未来能支持更多API功能。