Bruno

Bruno MCP Server lets you manage Bruno API testing assets through the Model Context Protocol, enabling automated generation of testing collections, environments, and requests. It integrates with MCP-compatible clients to streamline API testing workflows from creation to execution.

How to use

You interact with Bruno MCP Server through an MCP client to create and manipulate Bruno collections, environments, and requests. Start the server, then use available MCP tools to generate and organize your testing assets. You can add authentication, test scripts, and CRUD sets, and you can analyze collection statistics as you grow your test suites.

How to install

Prerequisites: Node.js and npm must be installed on your development machine.

Clone the Bruno MCP Server project, install dependencies, and build the project.

# Clone the repository
git clone https://github.com/macarthy/bruno-mcp.git
cd bruno-mcp

# Install dependencies
npm install

# Build the project
npm run build

Starting and running the server

To start the MCP server for normal development and testing, run the standard startup command.

npm start

Usage with an MCP client

Use an MCP client to drive the Bruno MCP Server. The Bruno MCP Server exposes tools to create collections, environments, and requests, and to generate CRUD operation sets. Example workflows include creating a new collection, adding one or more environments, generating .bru request files, and attaching pre/post scripts and assertions.

Project structure and tools you can use

The server provides a set of MCP tools to manage Bruno resources. Key tools include creating collections, environments, requests, CRUD sets, and adding test scripts.

Configuration and environment basics

The server supports environment configuration for different stages (development, staging, production) and can store authentication details or tokens within request configurations. Use the provided tools to build a structured testing setup that matches your API environments.

Notes on integration and workflows

You can integrate with Claude Desktop, Claude Code, and other MCP clients. The server is designed to work with standard MCP tooling to automate collection generation and testing workflows.

Troubleshooting and tips

If you encounter startup or tooling issues, verify you have Node.js and npm installed, re-run installation and build steps, and ensure you start the server with the correct start command. Check environment mappings in your collections to confirm base URLs and tokens are correctly configured.

Examples of common workflows

• Create a new Bruno collection with a base URL and an output path for generated files. - Create environments for development, staging, and production with appropriate variables like baseUrl and apiKey. - Generate requests for common HTTP methods and organize them into folders. - Add pre-request and post-response scripts to validate responses and extract data for subsequent requests. - Generate CRUD operation sets for an entity and include a baseUrl path prefix. - Retrieve collection statistics to monitor test coverage and usage.

Available tools (high level)

create_collection to initialize a Bruno collection, create_environment to define environment variables, create_request to generate .bru request files, create_crud_requests to build full CRUD sets, add_test_script to attach test scripts, and get_collection_stats to analyze a collection.

Security and access considerations

Handle authentication details and tokens securely within your environment configurations. Use environment-level secrets where possible and avoid hard-coding sensitive values in your collections.

Available tools

create_collection

Initialize a Bruno collection with configuration such as name, description, baseUrl, outputPath, and ignore list.

create_environment

Create environment configuration files for a Bruno collection, including collectionPath, name, and environment variables.

create_request

Generate .bru request files with details like collectionPath, name, method, url, headers, body, auth, and folder.

create_crud_requests

Generate complete CRUD operation sets for a given entity, including collectionPath, entityName, baseUrl, and optional folder.

add_test_script

Attach pre-request, post-response, or tests scripts to existing .bru files.

get_collection_stats

Retrieve statistics about a Bruno collection.