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

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.

• 📁 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

# 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

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

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

• ✅ 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

1. Start the MCP server:

npm start

2. Use the MCP Inspector to test tools:

npx @modelcontextprotocol/inspector

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

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

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 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 statistics about a collection.

Parameters:

• collectionPath (string): Path to collection

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

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);
  });
}

npm test

npm run test:integration

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

See the examples/ directory for complete usage examples:

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

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

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

npm run lint       # ESLint
npm run format     # Prettier

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

MIT License - see LICENSE file for details.

• Bruno API Client
• Model Context Protocol
• Bruno Documentation
• BRU Language Specification

Generated with Bruno MCP Server 🚀