Bruno MCP

🚀 Bruno MCP 服务器

一个启用运行Bruno集合的MCP（模型上下文协议）服务器。该服务器允许大型语言模型使用Bruno执行API测试，并通过标准接口获取详细的测试结果。

🚀 快速开始

Bruno MCP服务器能够让大型语言模型借助Bruno开展API测试，还能通过标准接口拿到详细的测试结果。下面为你介绍它的使用方法。

✨ 主要特性

• 使用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. 提供执行的人类可读摘要。

💻 使用示例

基础用法

以下是使用Smithery安装Bruno MCP Server的示例：

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

高级用法

以下是手动安装并构建项目的示例：

# 安装依赖项
npm install

# 构建项目
npm run build

🔧 技术细节

项目结构

src/
  ├── index.ts           # 入口点
  ├── server.ts          # MCP服务器实现
  ├── runner.ts          # Bruno运行器实现
  └── types.ts           # 类型定义

运行测试

# 运行测试
npm test

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

构建

# 构建项目
npm run build

# 清理构建文件
npm run clean

📄 许可证

MIT