Bruno MCP Server

Bruno MCP 服务

这是一个用于运行 Bruno 集合的 MCP（Model Context Protocol）服务。此服务允许大模型使用 Bruno 执行 API 测试，并通过标准化接口获取详细结果。

功能

• 使用 Bruno CLI 运行 Bruno 集合
• 支持环境文件
• 支持环境变量
• 提供详细的测试结果，包括：
  • 整体成功／失败状态
  • 测试摘要（总数、通过数、失败数）
  • 详细的失败信息
  • 执行耗时

安装

通过 Smithery 安装

通过 Smithery 自动为 Claude Desktop 安装 Bruno MCP 服务：

npx -y @smithery/cli install @hungthai1401/bruno-mcp --client claude

手动安装

# Install dependencies
npm install

# Build the project
npm run build

配置

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

{
  "mcpServers": {
    "bruno-runner": {
      "command": "npx",
      "args": ["-y", "bruno-mcp"],
    }
  }
}

可用工具

run-collection

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

参数：

• collection（必需）：Bruno 集合的路径
• environment（可选）：环境文件的路径
• variables（可选）：以键值对形式提供的环境变量

示例响应：

{
  "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 运行 Bruno 集合来使用此服务：

“运行位于 /path/to/collection.bru 的 Bruno 集合，并告诉我是否所有测试都通过了”

Claude 将：

1. 使用 run-collection 工具
2. 分析测试结果
3. 提供易于理解的执行摘要

开发

项目结构

src/
  ├── index.ts           # Entry point
  ├── server.ts          # MCP Server implementation
  ├── runner.ts          # Bruno runner implementation
  └── types.ts           # Type definitions

运行测试

# Run tests
npm test

# Run tests with coverage
npm test:coverage

构建

# Build the project
npm run build

# Clean build artifacts
npm run clean

许可证

MIT