Postman MCP 服务器

一个 MCP（模型上下文协议）服务器，支持使用 Newman 运行 Postman 集合。该服务器允许 LLM 执行 API 测试并通过标准化接口获取详细结果。

特征

使用 Newman 运行 Postman 集合
支持环境文件
支持全局变量
详细测试结果包括：
- 总体成功/失败状态
- 测试摘要（总计、通过、未通过）
- 详细故障信息
- 执行时间

安装

通过 Smithery 安装

要通过Smithery自动为 Claude Desktop 安装 Postman Runner：

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

手动安装

# Clone the repository
git clone <repository-url>
cd mcp-postman

# Install dependencies
pnpm install

# Build the project
pnpm build

用法

配置

将服务器添加到您的 Claude 桌面配置文件~/Library/Application Support/Claude/claude_desktop_config.json ：

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

可用工具

运行收集

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

参数：

collection （必需）：Postman collection 的路径或 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
  }
}

Claude 中的示例用法

您可以通过要求 Claude 中的服务器运行 Postman 集合来使用它：

“在 /path/to/collection.json 运行 Postman 集合并告诉我所有测试是否通过”

克劳德将：

使用运行收集工具
分析测试结果
提供人性化的执行摘要

发展

项目结构

src/
  ├── index.ts           # Entry point
  ├── server/
  │   ├── server.ts     # MCP Server implementation
  │   └── types.ts      # Type definitions
  └── newman/
      └── runner.ts     # Newman runner implementation
test/
  ├── server.test.ts    # Server tests
  ├── newman-runner.test.ts  # Runner tests
  └── fixtures/         # Test fixtures
      └── sample-collection.json

运行测试

# Run tests
pnpm test

# Run tests with coverage
pnpm test:coverage

建筑

# Build the project
pnpm build

# Clean build artifacts
pnpm clean

贡献

分叉存储库
创建你的功能分支（ git checkout -b feature/amazing-feature ）
提交您的更改（ git commit -m 'Add some amazing feature' ）
推送到分支（ git push origin feature/amazing-feature ）
打开拉取请求

执照

国际学习中心

Postman MCP Server

Integrations