Postman MCP Server

Postman MCP Server

site icon
2025.03.25 43
TypeScriptAPI 测试开发工具开发效率
mcp-postman 是一个基于 MCP(Model Context Protocol)的服务,主要用于运行 Postman 集合(collections)并获取详细的测试结果。它通过标准化的接口使 LLMs(大型语言模型)能够执行 API 测试,并返回包括测试状态、摘要、失败信息和执行时间等详细结果。
View on GitHub

Overview

基本能力

产品定位

mcp-postman 是一个 API 测试工具,专门用于运行 Postman 集合并返回详细的测试结果,适用于开发者和测试人员。

核心功能

  • 使用 Newman 运行 Postman 集合
  • 支持环境文件和全局变量
  • 提供详细的测试结果,包括:
  • 整体成功/失败状态
  • 测试摘要(总数、通过、失败)
  • 详细的失败信息
  • 执行时间

适用场景

  • 自动化 API 测试
  • 集成测试
  • 持续集成/持续部署(CI/CD)流程中的 API 测试

工具列表

run-collection

运行 Postman 集合并返回测试结果。

参数:

  • collection(必需):Postman 集合的路径或 URL
  • environment(可选):环境文件的路径或 URL
  • globals(可选):全局变量的路径或 URL
  • iterationCount(可选):运行的迭代次数

示例响应:

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

常见问题解答

无明确常见问题解答部分。

使用教程

使用依赖

无明确前置依赖教程。

安装教程

通过 Smithery 安装

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

手动安装

# 克隆仓库
git clone <repository-url>
cd mcp-postman

# 安装依赖
pnpm install

# 构建项目
pnpm build

调试方式

运行测试

# 运行测试
pnpm test

# 运行测试并生成覆盖率报告
pnpm test:coverage

构建项目

# 构建项目
pnpm build

# 清理构建产物
pnpm clean

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。