Servidor Bruno MCP

Un servidor MCP (Protocolo de Contexto de Modelo) que permite ejecutar colecciones de Bruno. Este servidor permite a los LLM ejecutar pruebas de API con Bruno y obtener resultados detallados mediante una interfaz estandarizada.

Características

• Ejecutar colecciones de Bruno mediante la CLI de Bruno

• Soporte para archivos de entorno

• Soporte para variables de entorno

• Resultados detallados de las pruebas que incluyen:

  • Estado general de éxito/fracaso

  • Resumen de la prueba (total, aprobado, reprobado)

  • Información detallada sobre fallos

  • Tiempos de ejecución

Related MCP server: API Testing MCP

Instalación

Instalación mediante herrería

Para instalar Bruno MCP Server para Claude Desktop automáticamente a través de 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

Agregue el servidor a su archivo de configuración de escritorio Claude en ~/Library/Application Support/Claude/claude_desktop_config.json :

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

Herramientas disponibles

colección de carreras

Ejecuta una colección de Bruno y devuelve los resultados de la prueba.

Parámetros:

• collection (obligatorio): Ruta a la colección 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:

Ejecute la colección Bruno en /path/to/collection.bru y dígame si se aprobaron todas las pruebas.

Claude querrá:

1. Utilice la herramienta de recopilación de ejecuciones

2. Analizar los resultados de las pruebas

3. Proporcionar un resumen comprensible 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

Ejecución de pruebas

# Run tests
npm test

# Run tests with coverage
npm test:coverage

Edificio

# Build the project
npm run build

# Clean build artifacts
npm run clean

Licencia

Instituto Tecnológico de Massachusetts (MIT)