vibe-check-mcp-server MCP — Casos de uso, Instalar & Demo en vivo

Name: vibe-check-mcp-server MCP Server
Author: PV-Bhat

Por qué usarlo

Características clave

La herramienta vibe_check interrumpe con objeciones antes de acciones irreversibles
vibe_learn captura lecciones por sesión para mejora en contexto
Las herramientas Constitution definen reglas por sesión que el agente debe seguir
Envoltura de prompt pura — ningún dato sale de tu proveedor LLM elegido

Demo en vivo

Cómo se ve en la práctica

vibe-check.replay ▶ listo

0/0

Instalar

Elige tu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "vibe-check": {
      "command": "npx",
      "args": [
        "-y",
        "vibe-check-mcp-server"
      ],
      "_inferred": true
    }
  }
}

Abre Claude Desktop → Settings → Developer → Edit Config. Reinicia después de guardar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "vibe-check": {
      "command": "npx",
      "args": [
        "-y",
        "vibe-check-mcp-server"
      ],
      "_inferred": true
    }
  }
}

Cursor usa el mismo esquema mcpServers que Claude Desktop. La configuración del proyecto prevalece sobre la global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "vibe-check": {
      "command": "npx",
      "args": [
        "-y",
        "vibe-check-mcp-server"
      ],
      "_inferred": true
    }
  }
}

Haz clic en el icono MCP Servers de la barra lateral de Cline y luego en "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "vibe-check": {
      "command": "npx",
      "args": [
        "-y",
        "vibe-check-mcp-server"
      ],
      "_inferred": true
    }
  }
}

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "vibe-check",
      "command": "npx",
      "args": [
        "-y",
        "vibe-check-mcp-server"
      ]
    }
  ]
}

Continue usa un array de objetos de servidor en lugar de un mapa.

~/.config/zed/settings.json

{
  "context_servers": {
    "vibe-check": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "vibe-check-mcp-server"
        ]
      }
    }
  }
}

Añádelo a context_servers. Zed recarga en caliente al guardar.

claude mcp add vibe-check -- npx -y vibe-check-mcp-server

Un solo comando. Verifica con claude mcp list. Quita con claude mcp remove.

Casos de uso

Usos del mundo real: vibe-check-mcp-server

Valida un plan antes de una acción destructiva con vibe-check

👤 Cualquiera que ejecute agentes con acceso de escritura ⏱ ~10 min beginner

Cuándo usarlo: El agente está a punto de eliminar archivos, ejecutar una migración o desplegar — quieres una segunda opinión.

Flujo

Invoca vibe_check en el plan

Antes de ejecutar la migración, invoca vibe_check en este plan: [pega]. ¿Qué podría salir mal?✓ Copiado

→ Lista de objeciones: suposiciones sin verificar, rollback faltante, expansión de alcance
Resuelve o ignora cada preocupación explícitamente

Aborda cada preocupación — ya sea mitigar o descartar explícitamente como fuera de alcance.✓ Copiado

→ Plan anotado listo para ejecutar

Resultado: Menos momentos de 'oh no' después de acciones destructivas.

Errores comunes

El agente descarta todas las preocupaciones de forma automática — Requiere que el agente reexponga cada preocupación y la mitigación específica

Combinar con: sequentialthinking-tools

Refuerza reglas de sesión con la constitución de vibe-check

👤 Equipos que comparten flujos de trabajo de agentes ⏱ ~10 min intermediate

Cuándo usarlo: Quieres que ciertas reglas (nunca hacer push a main, siempre escribir pruebas primero) se refuercen en toda la sesión.

Flujo

Establece la constitución

Usa update_constitution para establecer estas reglas para esta sesión: [lista]. Refuerza mediante CPI en cada llamada de herramienta que pudiera violarlas.✓ Copiado

→ Reglas reconocidas; violaciones posteriores se interrumpen
Inspecciona cuando tengas dudas

Invoca check_constitution para ver qué está actualmente en vigor.✓ Copiado

→ Lista de reglas actuales

Resultado: Comportamiento consistente del agente dentro de una sesión sin repetir reglas en cada mensaje.

Captura lecciones de errores del agente con vibe_learn

👤 Desarrolladores de agentes que iteran sobre prompts ⏱ ~5 min beginner

Cuándo usarlo: El agente cometió un error clásico; quieres que no se repita.

Flujo

Registra la lección

Invoca vibe_learn con: mistake='tabla de prod eliminada sin snapshot', lesson='siempre toma un snapshot antes de DDL en prod'.✓ Copiado

→ Lección almacenada para la sesión
Confía en ella más tarde

(más tarde en la misma sesión) Intenta un DDL — vibe_check muestra la lección almacenada✓ Copiado

→ Interrumpe con la lección pasada relevante

Resultado: Memoria en sesión de 'no hagas eso de nuevo' sin ingeniería de prompts.

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

vibe-check + sequentialthinking-tools

Plan + bucle de objeciones

Planifica con sequentialthinking_tools, luego invoca vibe_check en el plan antes de ejecutar el paso 1.✓ Copiado

vibe-check + overture

Plan visual + capa vibe-check

Después de que Overture produce el gráfico del plan, ejecuta vibe_check en él y muestra las preocupaciones como anotaciones.✓ Copiado

Herramientas

Lo que expone este MCP

Herramienta	Entradas	Cuándo llamar	Coste
vibe_check	plan: str, context?: str	Antes de cualquier acción no trivial o irreversible	1 llamada LLM a través de tu proveedor configurado
vibe_learn	mistake: str, lesson: str	Inmediatamente después de un error, mientras está fresco	0
update_constitution	rules: str[]	Inicio de sesión o cambio de política	0
check_constitution		Depura interrupciones inesperadas	0
reset_constitution		Comienza de nuevo	0

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API: Usa la cuota de tu LLM elegido
Tokens por llamada: 500-3000 para vibe_check
Monetario: Solo costo de token LLM
Consejo: Solo vibe_check en planes sustanciales — omitirlo en ediciones triviales ahorra tokens

Seguridad

Permisos, secretos, alcance

Almacenamiento de credenciales: Clave API de LLM en env (OPENAI_API_KEY, ANTHROPIC_API_KEY, etc.)

Salida de datos: Solo a tu proveedor LLM configurado

Resolución de problemas

Errores comunes y soluciones

vibe_check devuelve preocupaciones vacías

La entrada del plan fue demasiado vaga — incluye pasos concretos y efectos secundarios

El agente ignora la salida de vibe_check

Haz que el prompt del sistema requiera abordar cada preocupación antes de proceder

npx no encuentra @pv-bhat/vibe-check-mcp

El ámbito publicado es @pv-bhat; fija la última versión explícitamente: npx -y @pv-bhat/vibe-check-mcp@latest

Alternativas

vibe-check-mcp-server vs otros

Alternativa	Cuándo usarla	Contrapartida
sequentialthinking-tools	Quieres planificación, no objeciones	Forma diferente — sin modelo adversarial de segundo
overture	Quieres control visual en lugar de objeciones de texto	Configuración más pesada

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills