使用说明
项目简介
Bruno MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器,它允许大型语言模型 (LLM) 客户端通过标准化的接口运行 Bruno API 测试集合,并获取详细的测试结果。该服务器提供了一个工具,用于执行 Bruno 测试,并返回测试的成功状态、摘要、失败信息和执行时间等。
主要功能点
- 执行 Bruno API 集合:使用 Bruno CLI 运行 API 测试集合。
- 支持环境配置:支持 Bruno 环境变量文件和环境变量。
- 返回详细测试结果:提供全面的测试结果,包括:
- 整体成功/失败状态
- 测试摘要(总数、通过、失败)
- 详细的失败信息
- 执行时间
安装步骤
- 手动安装:
- 确保已安装 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 客户端。
信息
分类
开发者工具