convez.ai
MCP ServerIntegração & APIsIntermediário
hungthai1401

Bruno MCP Server

hungthai1401/bruno-mcp

Execute testes de API Bruno diretamente via Claude com resultados estruturados

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que integra o Bruno (ferramenta de testes de API) ao Claude, permitindo executar coleções de testes automaticamente via IA. Retorna resultados detalhados incluindo status de sucesso/falha, resumo de testes e timings de execução.

Instalação

$npx convez-ai hungthai1401/bruno-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
44
Forks
9
Acompanhando
1
Saúde
28%
Último commit
há 3 semanas
Versão
—
Issues abertas
1
Contribuidores
5

Casos de uso

  • Executar suites de testes de API automaticamente a partir de prompts
  • Validar integrações de API durante desenvolvimento com assistência IA
  • Gerar relatórios de teste através de análise de resultados por IA

Veredito

Ferramenta sólida que bridgeia bem Bruno com Claude, ideal para fluxos de teste de API assistidos por IA. Documentação clara e instalação simples via Smithery.

README

A tradução para o português deste README ainda está na fila.

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:

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 collection
  • environment (optional): Path to environment file
  • variables (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:

  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

# 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

Ver o original no GitHub

Bom para

Relacionados