Skip to main content
Glama

Bruno MCP Server

by macarthy
npmGitHub
TypeScript
MIT License
2
  • Apple
  • Linux
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Bruno MCP Server

A Model Context Protocol (MCP) server for generating Bruno API testing files programmatically.

Overview

Bruno MCP Server enables you to create, manage, and generate Bruno API testing collections, environments, and requests through standardized MCP tools. This allows for automated setup of API testing workflows and integration with Claude and other MCP-compatible clients.

Features

  • 📁 Collection Management: Create and organize Bruno collections
  • 🌍 Environment Configuration: Manage multiple environments (dev, staging, prod)
  • 🔧 Request Generation: Generate .bru files for all HTTP methods
  • 🔐 Authentication Support: Bearer tokens, Basic auth, OAuth 2.0, API keys
  • 📝 Test Scripts: Add pre/post request scripts and assertions
  • 🔄 CRUD Operations: Generate complete CRUD request sets
  • 📊 Collection Statistics: Analyze existing collections

Installation

# 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

Client Integration

The Bruno MCP Server can be integrated with various AI clients that support the Model Context Protocol:

Quick Setup for Claude Desktop

  1. Edit Claude Desktop config file:
    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%/Claude/claude_desktop_config.json
    • Linux: ~/.config/Claude/claude_desktop_config.json
  2. Add Bruno MCP Server:
    { "mcpServers": { "bruno-mcp": { "command": "node", "args": ["/absolute/path/to/bruno-mcp/dist/index.js"], "env": {} } } }
  3. Restart Claude Desktop

Supported Clients

  • ✅ Claude Desktop App - Full support
  • ✅ Claude Code (VS Code) - Full support
  • ✅ Continue - Tools and resources
  • ✅ Cline - Tools and resources
  • ✅ LM Studio - Tools support
  • ✅ MCP Inspector - Development/testing
  • ✅ Custom MCP Clients - via SDK

📖 For detailed integration instructions with all clients, see INTEGRATION.md

Usage

With Claude Code or MCP Inspector

  1. Start the MCP server:
npm start
  1. Use the MCP Inspector to test tools:
npx @modelcontextprotocol/inspector

Available MCP Tools

create_collection

Create a new Bruno collection with configuration.

Parameters:

  • name (string): Collection name
  • description (string, optional): Collection description
  • baseUrl (string, optional): Default base URL
  • outputPath (string): Directory to create collection
  • ignore (array, optional): Files to ignore

Example:

{ "name": "my-api-tests", "description": "API tests for my application", "baseUrl": "https://api.example.com", "outputPath": "./collections" }
create_environment

Create environment configuration files.

Parameters:

  • collectionPath (string): Path to Bruno collection
  • name (string): Environment name
  • variables (object): Environment variables

Example:

{ "collectionPath": "./collections/my-api-tests", "name": "production", "variables": { "baseUrl": "https://api.example.com", "apiKey": "prod-key-123", "timeout": 30000 } }
create_request

Generate .bru request files.

Parameters:

  • collectionPath (string): Path to collection
  • name (string): Request name
  • method (string): HTTP method
  • url (string): Request URL
  • headers (object, optional): HTTP headers
  • body (object, optional): Request body
  • auth (object, optional): Authentication config
  • folder (string, optional): Folder organization

Example:

{ "collectionPath": "./collections/my-api-tests", "name": "Get User Profile", "method": "GET", "url": "{{baseUrl}}/users/{{userId}}", "headers": { "Authorization": "Bearer {{token}}" }, "folder": "users" }
create_crud_requests

Generate complete CRUD operation sets.

Parameters:

  • collectionPath (string): Path to collection
  • entityName (string): Entity name (e.g., "Users")
  • baseUrl (string): API base URL
  • folder (string, optional): Folder name

Example:

{ "collectionPath": "./collections/my-api-tests", "entityName": "Products", "baseUrl": "{{baseUrl}}/api/v1", "folder": "products" }
add_test_script

Add test scripts to existing requests.

Parameters:

  • bruFilePath (string): Path to .bru file
  • scriptType (string): Script type (pre-request, post-response, tests)
  • script (string): JavaScript code
get_collection_stats

Get statistics about a collection.

Parameters:

  • collectionPath (string): Path to collection

Generated File Structure

my-collection/ ├── bruno.json # Collection configuration ├── environments/ # Environment files │ ├── development.bru │ ├── staging.bru │ └── production.bru ├── auth/ # Authentication requests │ ├── login.bru │ └── get-profile.bru └── users/ # User management ├── get-all-users.bru ├── get-user-by-id.bru ├── create-user.bru ├── update-user.bru └── delete-user.bru

Bruno BRU File Format

Generated .bru files follow the Bruno markup language specification:

meta { name: Get Users type: http seq: 1 } get { url: {{baseUrl}}/users body: none auth: none } headers { Content-Type: application/json Authorization: Bearer {{token}} } script:pre-request { bru.setVar("timestamp", Date.now()); } script:post-response { if (res.status === 200) { bru.setVar("userId", res.body[0].id); } } tests { test("Status should be 200", function() { expect(res.status).to.equal(200); }); }

Testing

Run Unit Tests

npm test

Run Integration Tests

npm run test:integration

Test with Bruno CLI

# Generate a collection first # Then run tests with Bruno CLI bruno-cli run ./collections/my-api-tests/

Examples

See the examples/ directory for complete usage examples:

  • examples/jsonplaceholder/ - JSONPlaceholder API testing
  • examples/authentication/ - Authentication workflows
  • examples/complex-workflows/ - Multi-step API scenarios

Development

Project Structure

src/ ├── index.ts # Main entry point ├── server.ts # MCP server implementation ├── bruno/ │ ├── types.ts # TypeScript interfaces │ ├── generator.ts # BRU file generator │ ├── collection.ts # Collection management │ ├── environment.ts # Environment management │ └── request.ts # Request builder └── tools/ # Individual MCP tools

Building

npm run build # Build TypeScript npm run dev # Development mode npm run clean # Clean build artifacts

Code Quality

npm run lint # ESLint npm run format # Prettier

Contributing

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Add tests
  5. Submit a pull request

License

MIT License - see LICENSE file for details.

Generated with Bruno MCP Server 🚀

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

How are these scores calculated?

A Model Context Protocol (MCP) server that enables programmatic creation and management of Bruno API testing collections, environments, and requests through standardized MCP tools.

  1. Overview
    1. Features
      1. Installation
        1. Client Integration
          1. Quick Setup for Claude Desktop
          2. Supported Clients
        2. Usage
          1. With Claude Code or MCP Inspector
          2. Available MCP Tools
        3. Generated File Structure
          1. Bruno BRU File Format
            1. Testing
              1. Run Unit Tests
              2. Run Integration Tests
              3. Test with Bruno CLI
            2. Examples
              1. Development
                1. Project Structure
                2. Building
                3. Code Quality
              2. Contributing
                1. License
                  1. Links

                    Related MCP Servers

                    • Bruno API MCP Server

                      djkz
                      -
                      security
                      F
                      license
                      -
                      quality
                      Exposes Bruno API collections as Model Context Protocol (MCP) tools, allowing AI agents and MCP clients to interact with your API collections.
                      Last updated -
                      1
                      TypeScript
                      • Linux

                    • MongoDB MCP Server

                      TeiNam
                      -
                      security
                      A
                      license
                      -
                      quality
                      A powerful Model Context Protocol (MCP) server implementation that provides standardized interaction with MongoDB databases, supporting complete CRUD operations, async patterns, and real-time updates via SSE.
                      Last updated -
                      Python
                      MIT License

                    • MCP Server

                      foxywolf-hub
                      -
                      security
                      A
                      license
                      -
                      quality
                      Model Context Protocol server that enables API test automation across various AI hosts (Claude, OpenAI, custom) using Postman Collections.
                      Last updated -
                      Python
                      MIT License

                    • MCP REST API Server

                      vinaykp
                      -
                      security
                      F
                      license
                      -
                      quality
                      A server implementation of the Model Context Protocol (MCP) that provides REST API endpoints for managing and interacting with MCP resources.
                      Last updated -
                      Python

                    View all related MCP servers

                    New MCP Servers

                    MCP directory API

                    We provide all the information about MCP servers via our MCP API.

                    curl -X GET 'https://glama.ai/api/mcp/v1/servers/macarthy/bruno-mcp'

                    If you have feedback or need assistance with the MCP directory API, please join our Discord server