Bruno MCP Server

A local-first, secure Model Context Protocol (MCP) server that enables AI coding assistants (like Cursor, Claude Desktop, and Aider) to discover, inspect, and run API requests in your Bruno collections entirely locally.

---

Key Features

• Local-First & Private: Executes API calls locally on your machine using your own local Bruno files and environments. No credentials or source files are sent to a cloud service.
• Universal Connection (MCP): Standardizes how AI coding agents query, analyze, and verify your back-end APIs.
• Tolerant Parsing: Extracts metadata (URL, headers, body types, bearer tokens) from .bru files while preserving the exact raw contents.
• Process Sandbox: Executes requests by calling your project-local @usebruno/cli directly with no shell interpolation, protecting against command injection.

---

Installation

Prerequisites

• Node.js >= 20.0.0
• A Bruno collection initialized in your workspace.

Running with npx

You can boot the server directly via npx:

npx bruno-mcp-server --project-path /absolute/path/to/your/bruno-collection

---

Client Configuration

1. Cursor

To configure the server in Cursor, open Settings -> Features -> MCP, click + Add New MCP Tool, and fill in the details:

• Name: bruno
• Type: stdio
• Command: node /absolute/path/to/bruno-mcp-server/dist/index.js --project-path /absolute/path/to/your/bruno-collection

2. Claude Desktop

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "bruno": {
      "command": "node",
      "args": [
        "/absolute/path/to/bruno-mcp-server/dist/index.js",
        "--project-path",
        "/absolute/path/to/your/bruno-collection"
      ]
    }
  }
}

---

Tool Reference

1. list_bruno_requests

Discovers and lists all .bru request files inside the collection root.

• Inputs:
  • project_path (string, optional)
• Output:
  • A JSON array listing request names, paths, and detected HTTP methods.

2. get_bruno_request_detail

Extracts structured request details (URL, headers, body, auth parameters) and raw content.

• Inputs:
  • request_name (string, required) - The name (relative path without extension, or unique basename) of the request.
  • project_path (string, optional)

3. run_bruno_request

Runs a request locally through the Bruno CLI and captures status and outputs.

• Inputs:
  • request_name (string, required)
  • project_path (string, optional)
  • env (string, optional) - Target environment defined in your collection.
  • env_vars (object, optional) - Key-value overrides for environment variables.

---

Development & Contribution

See CONTRIBUTING.md for local setup, testing, and contribution protocols.

License

MIT License. See LICENSE for details.