🚀 Bruno MCP 服务器

Bruno MCP 服务器是一个启用运行 Bruno 集合的 MCP（模型上下文协议）服务器。它允许大型语言模型使用 Bruno 执行 API 测试，并通过标准接口获取详细的测试结果，为 API 测试提供了高效且便捷的解决方案。

🚀 快速开始

Bruno MCP 服务器可让大型语言模型借助 Bruno 执行 API 测试。你可以通过 Smithery 自动安装，也能手动安装。安装完成后，进行简单配置即可使用。

✨ 主要特性

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

📦 安装指南

使用 Smithery 安装

可自动通过 Smithery 安装 Bruno MCP Server：

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

手动安装

# 安装依赖项
npm install

# 构建项目
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           # 入口点
  ├── server.ts          # MCP 服务器实现
  ├── runner.ts          # Bruno 运行器实现
  └── types.ts           # 类型定义

运行测试

# 运行测试
npm test

# 带代码覆盖率的测试
npm test:coverage

构建

# 构建项目
npm run build

# 清理构建文件
npm run clean

📄 许可证

本项目采用 MIT 许可证。