Bruno MCP服务器

一个MCP(模型上下文协议)服务器,支持运行Bruno集合,使LLM能够通过标准化接口执行API测试并获取详细结果。

  • by hungthai1401
  • JavaScript
  • 本地部署
  • 44 星标
  • 更新于
在 GitHub 查看 hungthai1401/bruno-mcp

使用说明

Bruno MCP服务器

支持运行Bruno集合的MCP(模型上下文协议)服务器。该服务器允许LLM使用Bruno执行API测试,并通过标准化接口获得详细结果。

特性

  • 使用Bruno CLI运行Bruno集合
  • 支持环境文件
  • 支持环境变量
  • 详细的测试结果包括:
    • 总体成功/失败状态
    • 测试总结(总计、通过、失败)
    • 详细的故障信息
    • 执行时间

安装

通过Smithery安装

通过以下方式自动安装Bruno MCP Server for Claude Desktop 史密瑟里:

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"],
    }
  }
}

可用工具

运行集合

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

参数:

  • collection (必填):布鲁诺系列之路
  • 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集合,并告诉我是否所有测试都通过”

克劳德将:

  1. 使用跑步收集工具
  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

许可证

麻省理工学院