Bruno MCP Server

Bruno MCP Server

An MCP server to run Bruno API test collections via a standardized interface.

32
Stars
8
Forks
32
Watchers
1
Issues
Bruno MCP Server provides an MCP-compliant server that enables running Bruno API collections and test suites, delivering detailed results through a standardized protocol interface. It supports the execution of API tests using Bruno CLI, allows integration with environment files and variables, and returns comprehensive success, summary, failure, and timing information. Designed for integration with LLMs such as Claude, it allows automated AI agents to initiate and analyze API collection runs. Deployment is streamlined through tools like Smithery and straightforward configuration for desktop use.

Key Features

Runs Bruno API collections via standardized MCP interface
Supports environment files for contextual testing
Handles custom environment variables
Delivers detailed test summaries with pass/fail statistics
Reports comprehensive failure details
Provides execution timing information
Integrates with Claude and other LLM-based environments
Easily installed through package managers or Smithery
Configurable for desktop environments
Automated and programmatic API test execution

Use Cases

Automated API test execution via LLM agents
Continuous integration testing for API workflows
Integration with desktop AI tools like Claude for live test runs
Debugging and validation of Bruno collection files
Batch API test reporting for developers
Programmatic evaluation of API behavior using environment configurations
Rapid feedback on API changes in collaborative teams
Environment-variable-based test customization
Automated analysis of API test pass/fail rates
Integrating with developer workflows for standardized test output

README

MseeP.ai Security Assessment Badge

Bruno MCP Server

Trust Score smithery badge

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:

bash
npx -y @smithery/cli install @hungthai1401/bruno-mcp --client claude

Manual Installation

bash
# 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:

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 collection
  • environment (optional): Path to environment file
  • variables (optional): Environment variables as key-value pairs

Example Response:

json
{
  "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:

  1. Use the run-collection tool
  2. Analyze the test results
  3. 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

bash
# Run tests
npm test

# Run tests with coverage
npm test:coverage

Building

bash
# Build the project
npm run build

# Clean build artifacts
npm run clean

License

MIT

Star History

Star History Chart

Repository Owner

Repository Details

Language JavaScript
Default Branch main
Size 76 KB
Contributors 5
MCP Verified Nov 12, 2025

Programming Languages

JavaScript
54.92%
TypeScript
42.17%
Dockerfile
2.9%

Tags

Join Our Newsletter

Stay updated with the latest AI tools, news, and offers by subscribing to our weekly newsletter.

We respect your privacy. Unsubscribe at any time.

Related MCPs

Discover similar Model Context Protocol servers

  • k6-mcp-server

    k6-mcp-server

    A Model Context Protocol server for orchestrating k6 load tests via MCP-enabled clients.

    k6-mcp-server implements the Model Context Protocol, allowing users to execute and manage k6 load testing scripts through standardized MCP clients. It provides a simple API, supports custom test durations and virtual users, and offers real-time execution output. The system is configurable via environment variables and can be easily integrated into existing MCP-compatible tooling.

    • 17
    • MCP
    • QAInsights/k6-mcp-server
  • Octomind MCP Server

    Octomind MCP Server

    Let agents create and manage automated end-to-end tests with Octomind.

    Octomind MCP Server enables agents to interact with Octomind's end-to-end testing platform, allowing the creation, execution, and management of automated tests. It provides a server that integrates with various clients and allows for configuration, session management, and access to multiple testing tools and resources. The server supports extensible session storage options and integrates with external platforms like TestRail and Redis for advanced scenarios. It is designed to facilitate local development and enhance test management workflows.

    • 21
    • MCP
    • OctoMind-dev/octomind-mcp
  • QA Sphere MCP Server

    QA Sphere MCP Server

    Model Context Protocol server enabling LLMs to interact with QA Sphere test cases

    QA Sphere MCP Server provides a Model Context Protocol (MCP) integration for QA Sphere, allowing Large Language Models to interact with, discover, and summarize test cases within the QA Sphere test management system. It enables AI-powered IDEs and MCP clients to reference and manipulate QA Sphere test case data within development workflows. The solution supports quick integration into clients like Claude, Cursor, and 5ire, facilitating seamless collaboration and context sharing for AI-assisted development.

    • 15
    • MCP
    • Hypersequent/qasphere-mcp
  • Facebook/Meta Ads MCP Server

    Facebook/Meta Ads MCP Server

    MCP server interface for secure, programmatic Meta Ads data and management.

    Enables seamless integration between Model Context Protocol (MCP) clients and Meta (Facebook) Ads API, providing tools for programmatic data access and campaign management. Simplifies local installation with automated environment setup and optional secure authentication, eliminating the need for manual token retrieval. Designed for use with popular MCP clients such as Claude Desktop, offering plug-and-play connectivity. Data and tokens remain local for privacy and security.

    • 183
    • MCP
    • gomarble-ai/facebook-ads-mcp-server
  • Globalping MCP Server

    Globalping MCP Server

    Enable AI models to run network tests globally via natural language.

    Globalping MCP Server implements the Model Context Protocol, enabling AI models to interface with a global network measurement platform through natural language. It allows AI clients to perform network diagnostic tests such as ping, traceroute, DNS, MTR, and HTTP from thousands of locations worldwide. The server offers AI-friendly context handling, detailed parameter descriptions, comparative analysis of network performance, and supports secure authentication using OAuth or API tokens.

    • 33
    • MCP
    • jsdelivr/globalping-mcp-server
  • pharo-smalltalk-interop-mcp-server

    pharo-smalltalk-interop-mcp-server

    Local MCP server enabling advanced Pharo Smalltalk integration and introspection.

    pharo-smalltalk-interop-mcp-server implements the Model Context Protocol (MCP) and enables communication with a local Pharo Smalltalk image. It offers capabilities such as code evaluation, code introspection, search and discovery, package management, project installation, test execution, and UI debugging. The server is configured to integrate with tools like Cursor and Claude Code, providing a standardized API for programmatic Smalltalk interaction.

    • 6
    • MCP
    • mumez/pharo-smalltalk-interop-mcp-server
  • Didn't find tool you were looking for?

    Be as detailed as possible for better results