使用说明

项目简介

Bruno MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器,它允许大型语言模型 (LLM) 客户端通过标准化的接口运行 Bruno API 测试集合,并获取详细的测试结果。该服务器提供了一个工具,用于执行 Bruno 测试,并返回测试的成功状态、摘要、失败信息和执行时间等。

主要功能点

  • 执行 Bruno API 集合:使用 Bruno CLI 运行 API 测试集合。
  • 支持环境配置:支持 Bruno 环境变量文件和环境变量。
  • 返回详细测试结果:提供全面的测试结果,包括:
    • 整体成功/失败状态
    • 测试摘要(总数、通过、失败)
    • 详细的失败信息
    • 执行时间

安装步骤

  1. 手动安装:
    • 确保已安装 Node.js 和 npm。
    • 克隆此 GitHub 仓库到本地。
    • 在终端中导航到仓库目录。
    • 运行 'npm install' 安装项目依赖。
    • 运行 'npm run build' 构建项目。

服务器配置

要在一个 MCP 客户端(例如 Claude Desktop)中配置此 MCP 服务器,您需要添加一个服务器配置条目。以下是一个 JSON 格式的配置示例:

{
  "mcpServers": {
    "bruno-runner": { // 服务器名称,可以自定义
      "command": "npx", // 启动服务器的命令,这里使用 npx 来运行本地安装的 bruno-mcp 包
      "args": ["-y", "bruno-mcp"] // 命令参数,"-y" 可能是为了自动确认执行, "bruno-mcp" 是要执行的服务器包名
    }
  }
}
  • 'server name': 'bruno-runner' (您可以自定义服务器名称)。
  • 'command': 'npx' (Node Package Execute,假设 'bruno-mcp' 在 npm install 和 build 后可以通过 npx 访问)。
  • 'args': '["-y", "bruno-mcp"]' ('-y' 标志可能不是必需的, 'bruno-mcp' 是要执行的包名称)。

基本使用方法

配置完成后,MCP 客户端(如 Claude)可以使用此服务器提供的 'run-collection' 工具。要运行 Bruno 集合,您通常需要指示 LLM 客户端使用 'run-collection' 工具,并提供 Bruno 集合文件的路径作为参数。例如,您可以向 Claude 提出类似这样的请求:“运行 '/path/to/collection.bru' 的 Bruno 集合,并告诉我所有测试是否通过。” 服务器将执行 Bruno 集合,并将测试结果以 JSON 格式返回给 LLM 客户端。

信息

分类

开发者工具