What is Bruno Mcp

bruno-mcp is an MCP (Model Context Protocol) server designed for executing Bruno collections. It facilitates API testing for large language models (LLMs) and provides detailed results through a standardized interface.

Use cases

Use cases for bruno-mcp include running automated API tests for applications, validating API responses during development, and integrating with CI/CD pipelines to ensure API reliability.

How to use

To use bruno-mcp, you can install it via Smithery or manually. After installation, configure it in your Claude desktop configuration file. You can run a Bruno collection by specifying the collection path and optional environment variables.

Key features

Key features of bruno-mcp include the ability to run Bruno collections using the Bruno CLI, support for environment files and variables, and detailed test results that include overall success/failure status, test summary, detailed failure information, and execution timings.

Where to use

bruno-mcp can be used in software development and testing environments where API testing is required, particularly in projects utilizing large language models.

Bruno MCP Server

An MCP (Model Context Protocol) server that enables running Bruno collections. This server allows LLMs to execute API tests using Bruno and get detailed results through a standardized interface.

Features

• Run Bruno collections using the Bruno CLI
• Support for environment files
• Support for environment variables
• Detailed test results including:
  • Overall success/failure status
  • Test summary (total, passed, failed)
  • Detailed failure information
  • Execution timings

Installation

Installing via Smithery

To install Bruno MCP Server for Claude Desktop automatically via Smithery:

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

Manual Installation

# Install dependencies
npm install

# Build the project
npm run build

Configuration

Add the server to your Claude desktop configuration file at ~/Library/Application Support/Claude/claude_desktop_config.json:

Available Tools

run-collection

Runs a Bruno collection and returns the test results.

Parameters:

• collection (required): Path to the Bruno collection
• environment (optional): Path to environment file
• variables (optional): Environment variables as key-value pairs

Example Response:

{
  "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
  }
}

Example Usage in Claude

You can use the server in Claude by asking it to run a Bruno collection:

“Run the Bruno collection at /path/to/collection.bru and tell me if all tests passed”

Claude will:

1. Use the run-collection tool
2. Analyze the test results
3. Provide a human-friendly summary of the execution

Development

Project Structure

src/
  ├── index.ts           # Entry point
  ├── server.ts          # MCP Server implementation
  ├── runner.ts          # Bruno runner implementation
  └── types.ts           # Type definitions

Running Tests

# Run tests
npm test

# Run tests with coverage
npm test:coverage

Building

# Build the project
npm run build

# Clean build artifacts
npm run clean

License

MIT