Bruno MCP Server

Bruno MCP Server

Un servidor MCP (Model Context Protocol) que permite ejecutar colecciones de Bruno. Este servidor permite a los LLMs ejecutar pruebas de API usando Bruno y obtener resultados detallados a través de una interfaz estandarizada.

Características

• Ejecutar colecciones de Bruno usando la CLI de Bruno
• Soporte para archivos de entorno
• Soporte para variables de entorno
• Resultados detallados de pruebas que incluyen:
  • Estado general de éxito/fallo
  • Resumen de pruebas (total, aprobadas, fallidas)
  • Información detallada de fallos
  • Tiempos de ejecución

Instalación

Instalación mediante Smithery

Para instalar Bruno MCP Server para Claude Desktop automáticamente mediante Smithery:

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

Instalación manual

# Install dependencies
npm install

# Build the project
npm run build

Configuración

Agrega el servidor a tu archivo de configuración de Claude Desktop en ~/Library/Application Support/Claude/claude_desktop_config.json:

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

Herramientas Disponibles

run-collection

Ejecuta una colección de Bruno y devuelve los resultados de las pruebas.

Parámetros:

• collection (obligatorio): Ruta a la colección de Bruno
• environment (opcional): Ruta al archivo de entorno
• variables (opcional): Variables de entorno como pares clave-valor

Ejemplo de respuesta:

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

Ejemplo de uso en Claude

Puedes usar el servidor en Claude pidiéndole que ejecute una colección de Bruno:

"Ejecuta la colección de Bruno en /path/to/collection.bru y dime si todas las pruebas pasaron"

Claude hará lo siguiente:

1. Usar la herramienta run-collection
2. Analizar los resultados de las pruebas
3. Proporcionar un resumen amigable para humanos de la ejecución

Desarrollo

Estructura del Proyecto

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

Ejecutar Pruebas

# Run tests
npm test

# Run tests with coverage
npm test:coverage

Compilación

# Build the project
npm run build

# Clean build artifacts
npm run clean

Licencia

MIT