bruno

The Bruno MCP Server enables automated generation and management of Bruno API testing assets. It provides tools to create Bruno collections, environments, and requests, generate complete CRUD operation sets, add test scripts, and analyze collection statistics. This server is designed to integrate with Claude and other MCP-compatible clients, allowing you to drive your API testing workflows from a centralized MCP interface. To start using it, run the server locally and connect your MCP clients to the bruno-mcp endpoint to issue commands such as create_collection, create_environment, create_request, and create_crud_requests. The tooling supports authentication configuration, pre/post-request scripts, and assertion blocks to help you build robust API test suites.

Prerequisites:

• Node.js (LTS version) installed on your machine
• Git installed

Installation steps:

1. Clone the repository git clone https://github.com/macarthy/bruno-mcp.git
2. Navigate to the project directory cd bruno-mcp
3. Install dependencies npm install
4. Build the project npm run build
5. Start the MCP server npm start

Notes:

• Ensure you have network access if the build step needs to fetch dependencies.
• You can customize environment variables or config as needed for your environment.

Tips and common issues:

• The server exposes MCP tools for collections, environments, and requests; ensure your client is configured to target the running bruno-mcp server.
• If you run into port conflicts, verify the server's listen port in the environment or configuration (consult your deployment docs).
• When integrating with Claude or other clients, use an absolute path to the built dist/index.js in the MCP server configuration as shown in the example.
• For authentication in requests, provide the appropriate auth config in create_request or in environment variables as needed by your API.
• Use create_crud_requests to rapidly scaffold standard CRUD operations for an entity, then refine the generated BRU files as needed.