About hungthai1401/bruno-mcp
hungthai1401/bruno-mcp is an MCP server published by hungthai1401 in the Data category: mCP Server for running Bruno Collections.
The repository has 44 stars and 10 forks, with the last commit a year ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.
Install
git clone https://github.com/hungthai1401/bruno-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
Ask AI about hungthai1401/bruno-mcp
Powered by Claude · Grounded in docs
Security checks
Static checks derived from the repository yesterday. Heuristics on the source, not an audit.
- ✓README presentThe repository ships documentation.
- !License declaredNo license file. Legally you have no right to use it in a product.
- !Tests presentNo tests found. Behaviour changes may go unnoticed between versions.
- ✓Dependencies pinnedA lockfile pins dependency versions.
- ✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
README
Bruno MCP Server
An 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.
Features
- Run Bruno collections using the Bruno CLI
- Support for environment files
- Support for environment variables
- Detailed test results including:
- Overall success/failure status
- Test summary (total, passed, failed)
- Detailed failure information
- Execution timings
Installation
Installing via Smithery
To install Bruno MCP Server for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @hungthai1401/bruno-mcp --client claude
Manual Installation
# Install dependencies
npm install
# Build the project
npm run build
Configuration
Add the server to your Claude desktop configuration file at ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"bruno-runner": {
"command": "npx",
"args": ["-y", "bruno-mcp"],
}
}
}
Available Tools
run-collection
Runs a Bruno collection and returns the test results.
Parameters:
collection(required): Path to the Bruno collectionenvironment(optional): Path to environment filevariables(optional): Environment variables as key-value pairs
Example Response:
{
"success": true,
"summary": {
"total": 5,
"failed": 0,
"passed": 5
},
"failures": [],
"timings": {
"started": "2024-03-14T10:00:00.000Z",
"completed": "2024-03-14T10:00:01.000Z",
"duration": 1000
}
}
Example Usage in Claude
You can use the server in Claude by asking it to run a Bruno collection:
"Run the Bruno collection at /path/to/collection.bru and tell me if all tests passed"
Claude will:
- Use the run-collection tool
- Analyze the test results
- Provide a human-friendly summary of the execution
Development
Project Structure
src/
├── index.ts # Entry point
├── server.ts # MCP Server implementation
├── runner.ts # Bruno runner implementation
└── types.ts # Type definitions
Running Tests
# Run tests
npm test
# Run tests with coverage
npm test:coverage
Building
# Build the project
npm run build
# Clean build artifacts
npm run clean
License
MIT
README fetched from the repository yesterday. The original is authoritative.