Bruno

MCP Server for running Bruno Collections

javascript

37

GitHub Stars

javascript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "hungthai1401-bruno-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "bruno-mcp"
      ]
    }
  }
}

Bruno MCP Server lets you run Bruno collections through an MCP interface, providing structured test results to enable automated testing and verification by large language models and other clients.

How to use

You can run Bruno collections from an MCP client by using the Bruno MCP Server as a bridge between Bruno workflows and your testing client. Use the Run Bruno Collection capability to execute a Bruno collection and obtain a detailed result set that includes the overall status, a test summary, any failures, and execution timings. Your client will receive a structured result you can inspect programmatically to determine success, diagnose failures, or drive subsequent actions.

Typical usage pattern with an MCP client: point the client at the Bruno MCP Server, request a Bruno collection to run, optionally supply an environment file or environment variables, and then read back the execution summary and any failure details. The server handles executing the collection and returning a standardized result so your client can interpret success, failures, and timings without needing to parse raw test output.

How to install

Prerequisites: you need Node.js and npm installed on your machine.

Option 1: Install via Smithery (automatic for Claude Desktop)

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

Option 2: Manual installation

# Install dependencies
npm install

# Build the project
npm run build

Configuration

Configure the Claude desktop to include the Bruno MCP Server so you can run Bruno collections from Claude. Add a server entry to your Claude desktop configuration:

{
  "mcpServers": {
    "bruno-runner": {
      "command": "npx",
      "args": ["-y", "bruno-mcp"]
    }
  }
}

Available tools

run-collection

Runs a Bruno collection and returns a structured test result including overall status, summary (total, passed, failed), detailed failures, and timing information.