MCP-Postman API测试工具

你是否曾经希望AI能够自动运行Postman集合，执行API测试，并分析测试结果？今天要介绍的开源项目MCP-Postman API测试工具，正是为了实现这个目标而设计的。它通过Newman运行Postman集合，让AI能够执行API测试并获取详细的结果分析。

项目基本信息

一、项目介绍

MCP-Postman API测试工具是一个MCP服务器，让AI能够通过Newman运行Postman集合。它支持环境文件、全局变量，并提供详细的测试结果分析。

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

• run-collection：运行Postman集合并返回测试结果

二、核心优势

API测试自动化

让AI自动运行Postman集合，执行API测试。

详细结果分析

测试结果包括：

• 总体成功/失败状态
• 测试摘要（总数、通过数、失败数）
• 详细的失败信息
• 执行时间

灵活配置

支持环境文件和全局变量。

多来源支持

集合、环境、全局变量支持本地路径或URL。

三、适用场景

CI/CD集成

在CI/CD流程中，让AI自动运行API测试并分析结果。

测试自动化

AI可以定期运行Postman集合，监控API健康状态。

开发辅助

在开发过程中，AI可以快速运行API测试并反馈结果。

回归测试

AI可以自动执行回归测试，确保API变更不引入问题。

四、安装教程

系统要求

安装步骤

第一步：克隆项目并安装依赖

git clone https://github.com/shannonlal/mcp-postman.git
cd mcp-postman
pnpm install
pnpm build

第二步：配置Claude Desktop

找到配置文件：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

添加配置：

{
  "mcpServers": {
    "postman-runner": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-postman/build/index.js"]
    }
  }
}

第三步：通过Smithery安装（可选）

npx -y @smithery/cli install mcp-postman --client claude

第四步：重启Claude Desktop

保存配置后，重启Claude Desktop。

五、使用示例

配置完成后，你就可以在MCP客户端中使用自然语言来运行Postman测试了。

示例1：运行本地集合

用户指令：“运行位于/path/to/collection.json的Postman集合”

AI会调用run-collection工具：

{
  "collection": "/path/to/collection.json"
}

示例2：带环境文件运行

用户指令：“使用环境文件/path/to/env.json运行集合”

{
  "collection": "/path/to/collection.json",
  "environment": "/path/to/env.json"
}

示例3：带全局变量运行

用户指令：“使用全局变量文件运行集合”

{
  "collection": "/path/to/collection.json",
  "globals": "/path/to/globals.json"
}

示例4：指定迭代次数

用户指令：“运行集合3次迭代”

{
  "collection": "/path/to/collection.json",
  "iterationCount": 3
}

示例5：使用URL运行

用户指令：“运行位于https://example.com/collection.json的集合”

{
  "collection": "https://example.com/collection.json"
}

六、响应格式

运行成功后，返回以下格式的结果：

{
  "success": true,
  "summary": {
    "total": 5,
    "failed": 0,
    "passed": 5
  },
  "failures": [],
  "timings": {
    "started": "2024-03-14T10:00:00.000Z",
    "completed": "2024-03-14T10:01:00.000Z",
    "duration": 1000
  }
}

如果测试失败，failures数组会包含详细的失败信息。

七、常见问题

问题1：Newman未安装

解决方案：运行npm install -g newman安装Newman。

问题2：集合文件不存在

解决方案：确认文件路径正确，使用绝对路径。

问题3：环境变量未生效

解决方案：检查环境文件格式是否正确，确保变量名称匹配。

问题4：迭代次数限制

解决方案：迭代次数没有硬性限制，但建议合理设置。

问题5：URL格式不正确

解决方案：确保URL是有效的HTTP/HTTPS地址。

八、总结

MCP-Postman API测试工具是一个专注于API测试自动化的MCP服务器，让AI能够通过Newman运行Postman集合并分析结果。

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

1. API测试自动化：让AI自动运行Postman集合
2. 详细结果分析：提供测试摘要和失败详情
3. 灵活配置：支持环境文件和全局变量
4. 多来源支持：本地文件或URL
5. 易于集成：通过MCP协议与AI客户端集成

如果你是API开发者或测试工程师，并且希望用AI来自动化API测试，MCP-Postman API测试工具是一个非常实用的选择。