Bruno MCP Server

1[![MseeP.ai Security Assessment Badge](https://mseep.net/pr/hungthai1401-bruno-mcp-badge.png)](https://mseep.ai/app/hungthai1401-bruno-mcp)
2 
3# Bruno MCP Server
4<a href="https://glama.ai/mcp/servers/@hungthai1401/bruno-mcp">
5  <img width="380" height="200" src="https://glama.ai/mcp/servers/@hungthai1401/bruno-mcp/badge" alt="Bruno MCP server" />
6</a>
7 
8[![Trust Score](https://archestra.ai/mcp-catalog/api/badge/quality/hungthai1401/bruno-mcp)](https://archestra.ai/mcp-catalog/hungthai1401__bruno-mcp)
9[![smithery badge](https://smithery.ai/badge/@hungthai1401/bruno-mcp)](https://smithery.ai/server/@hungthai1401/bruno-mcp)
10 
11An MCP (Model Context Protocol) server that enables running Bruno collections. This server allows LLMs to execute API tests using Bruno and get detailed results through a standardized interface.
12 
13## Features
14 
15* Run Bruno collections using the Bruno CLI
16* Support for environment files
17* Support for environment variables
18* Detailed test results including:
19  * Overall success/failure status
20  * Test summary (total, passed, failed)
21  * Detailed failure information
22  * Execution timings
23 
24## Installation
25 
26### Installing via Smithery
27 
28To install Bruno MCP Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@hungthai1401/bruno-mcp):
29 
30```bash
31npx -y @smithery/cli install @hungthai1401/bruno-mcp --client claude
32```
33 
34### Manual Installation
35```bash
36# Install dependencies
37npm install
38 
39# Build the project
40npm run build
41```
42 
43## Configuration
44 
45Add the server to your Claude desktop configuration file at `~/Library/Application Support/Claude/claude_desktop_config.json`:
46 
47```json
48{
49  "mcpServers": {
50    "bruno-runner": {
51      "command": "npx",
52      "args": ["-y", "bruno-mcp"],
53    }
54  }
55}
56```
57 
58## Available Tools
59 
60### run-collection
61 
62Runs a Bruno collection and returns the test results.
63 
64**Parameters:**
65 
66* `collection` (required): Path to the Bruno collection
67* `environment` (optional): Path to environment file
68* `variables` (optional): Environment variables as key-value pairs
69 
70**Example Response:**
71 
72```json
73{
74  "success": true,
75  "summary": {
76    "total": 5,
77    "failed": 0,
78    "passed": 5
79  },
80  "failures": [],
81  "timings": {
82    "started": "2024-03-14T10:00:00.000Z",
83    "completed": "2024-03-14T10:00:01.000Z",
84    "duration": 1000
85  }
86}
87```
88 
89### Example Usage in Claude
90 
91You can use the server in Claude by asking it to run a Bruno collection:
92 
93"Run the Bruno collection at /path/to/collection.bru and tell me if all tests passed"
94 
95Claude will:
961. Use the run-collection tool
972. Analyze the test results
983. Provide a human-friendly summary of the execution
99 
100## Development
101 
102### Project Structure
103 
104```
105src/
106  ├── index.ts           # Entry point
107  ├── server.ts          # MCP Server implementation
108  ├── runner.ts          # Bruno runner implementation
109  └── types.ts           # Type definitions
110```
111 
112### Running Tests
113 
114```bash
115# Run tests
116npm test
117 
118# Run tests with coverage
119npm test:coverage
120```
121 
122### Building
123 
124```bash
125# Build the project
126npm run build
127 
128# Clean build artifacts
129npm run clean
130```
131 
132## License
133 
134MIT