你是否曾经希望根据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 |
| 开源状态 | 公开状态 |
| Languages | TypeScript |
| 支持平台 | 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密钥
- 登录Postman
- 进入API Keys设置
- 生成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框架。
这个项目的最大价值在于:
- 自动生成:从Postman到AI工具
- 多框架:6种主流框架
- 类型安全:TypeScript支持
- 完整代码:错误处理+函数定义
- MIT许可证:可自由使用
如果你需要使用Postman API集成AI代理,Postman AI工具生成器是一个非常实用的工具。
作为开发者,这个工具很实用。
希望未来能支持批量生成。
已经加星,期待功能完善。
MIT协议开源,可以自由使用。
和手动写API代码相比,这个自动化。