Bruno MCP Server

Bruno MCP Server

Um servidor MCP (Model Context Protocol) que permite executar coleções do Bruno. Este servidor permite que LLMs executem testes de API usando o Bruno e obtenham resultados detalhados por meio de uma interface padronizada.

Recursos

• Executar coleções do Bruno usando a CLI do Bruno
• Suporte para arquivos de ambiente
• Suporte para variáveis de ambiente
• Resultados detalhados de testes, incluindo:
  • Status geral de sucesso/falha
  • Resumo dos testes (total, aprovados, reprovados)
  • Informações detalhadas de falhas
  • Tempos de execução

Instalação

Instalando via Smithery

Para instalar o Bruno MCP Server para Claude Desktop automaticamente via Smithery:

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

Instalação Manual

# Install dependencies
npm install

# Build the project
npm run build

Configuração

Adicione o servidor ao arquivo de configuração do Claude Desktop em ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "bruno-runner": {
      "command": "npx",
      "args": ["-y", "bruno-mcp"],
    }
  }
}

Ferramentas Disponíveis

run-collection

Executa uma coleção do Bruno e retorna os resultados dos testes.

Parâmetros:

• collection (obrigatório): Caminho para a coleção do Bruno
• environment (opcional): Caminho para o arquivo de ambiente
• variables (opcional): Variáveis de ambiente como pares chave-valor

Exemplo de Resposta:

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

Exemplo de Uso no Claude

Você pode usar o servidor no Claude pedindo para ele executar uma coleção do Bruno:

"Execute a coleção do Bruno em /path/to/collection.bru e me diga se todos os testes passaram"

O Claude irá:

1. Usar a ferramenta run-collection
2. Analisar os resultados dos testes
3. Fornecer um resumo amigável da execução

Desenvolvimento

Estrutura do Projeto

src/
  ├── index.ts           # Entry point
  ├── server.ts          # MCP Server implementation
  ├── runner.ts          # Bruno runner implementation
  └── types.ts           # Type definitions

Executando Testes

# Run tests
npm test

# Run tests with coverage
npm test:coverage

Compilação

# Build the project
npm run build

# Clean build artifacts
npm run clean

Licença

MIT