Vibe Check MCP

by PV-Bhat
Verified

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Enables environment variable configuration through a .env file to store API keys and other configuration values.

  • Hosted on GitHub with repository access for cloning, contributing, and accessing documentation and case studies.

  • Supports installation and management of dependencies through npm, with commands for building and running the server.

🧠 Comprobación de vibración MCP

También puede encontrar Vibecheck en: mcpservers.org , Glama.ai , mcp.so

El patito de goma interno de tu IA cuando no puede patita de goma por sí solo.

¿Qué es Vibe Check?

En la era de la "codificación de vibraciones" , los agentes de IA ahora tienen capacidades increíbles, pero la pregunta ahora se ha trasladado:

de

"¿Puede mi agente de IA realmente realizar esta compleja tarea ?"

a

"¿Puede mi agente de IA entender que quiero escribir un programa simple , no una infraestructura para una empresa tecnológica multimillonaria ?"

Proporciona el momento esencial de "¡Espera... esto no es!" que los agentes de IA actualmente no tienen: una capa de supervisión autocorrectiva integrada. Es el servidor MCP definitivo para la comprobación de la cordura de Vibe Coder.

  • Evite errores en cascada en los flujos de trabajo de IA implementando interrupciones de patrones estratégicos.
  • Utiliza la herramienta llamada "Vibe Check" con LearnLM 1.5 Pro (Gemini API), optimizada para la pedagogía y la metacognición para mejorar la estrategia de flujo de trabajo compleja y evitar errores de visión de túnel.
  • Implementa "Vibe Distill" para fomentar la simplificación del plan, evitar soluciones de ingeniería excesiva y minimizar la deriva contextual en los agentes.
  • Bucles de retroalimentación de automejora: los agentes pueden registrar errores en "Vibe Learn" para mejorar la recuperación semántica y ayudar a la IA de supervisión a identificar patrones a lo largo del tiempo.

TLDR: Implemente un agente optimizado para detener a su agente y hacerle reconsiderar antes de que implemente con confianza algo incorrecto.

El problema: la inercia del patrón

En el movimiento de codificación vibrante, todos usamos LLM para generar, refactorizar y depurar nuestro código. Pero estos modelos tienen un defecto crítico: una vez que comienzan a seguir un camino de razonamiento, continúan incluso si este es claramente erróneo.

You: "Parse this CSV file" AI: "First, let's implement a custom lexer/parser combination that can handle arbitrary CSV dialects with an extensible architecture for future file formats..." You: *stares at 200 lines of code when you just needed to read 10 rows*

Esta inercia del patrón conduce a:

  • 🔄 Visión de túnel : Su agente se queda estancado en un enfoque, incapaz de ver alternativas.
  • 📈 Aumento del alcance : las tareas simples evolucionan gradualmente hasta convertirse en soluciones a escala empresarial
  • 🔌 Sobreingeniería : Añadir capas de abstracción a problemas que no las necesitan
  • Desalineación : Resolver un problema adyacente pero diferente al que usted solicitó

Características: Herramientas de supervisión metacognitiva

Vibe Check agrega una capa metacognitiva a los flujos de trabajo de sus agentes con tres herramientas integradas:

🛑 comprobación de vibraciones

Mecanismo de interrupción de patrones que rompe la visión de túnel con el cuestionamiento metacognitivo:

vibe_check({ "phase": "planning", // planning, implementation, or review "userRequest": "...", // FULL original user request "plan": "...", // Current plan or thinking "confidence": 0.7 // Optional: 0-1 confidence level })

⚓ vibra_distill

Punto de anclaje del metapensamiento que recalibra flujos de trabajo complejos:

vibe_distill({ "plan": "...", // Detailed plan to simplify "userRequest": "..." // FULL original user request })

🔄 vibra_aprender

Bucle de retroalimentación de automejora que genera reconocimiento de patrones a lo largo del tiempo:

vibe_learn({ "mistake": "...", // One-sentence description of mistake "category": "...", // From standard categories "solution": "..." // How it was corrected })

Vibe Check en acción

Antes de comprobar la vibración:

Claude asume el significado de MCP a pesar de la ambigüedad, lo que lleva a que todos los pasos posteriores tengan esta suposición errónea.

Después de comprobar la vibración:

Se llama Vibe Check MCP y señala la ambigüedad, lo que obliga a Claude a reconocer esta falta de información y abordarla de manera proactiva.

Instalación y configuración

Instalación mediante herrería

Para instalar vibe-check-mcp-server para Claude Desktop automáticamente a través de Smithery :

npx -y @smithery/cli install @PV-Bhat/vibe-check-mcp-server --client claude

Instalación manual mediante npm (recomendado)

# Clone the repo git clone https://github.com/PV-Bhat/vibe-check-mcp-server.git cd vibe-check-mcp-server # Install dependencies npm install # Build the project npm run build # Start the server npm run start

Integración con Claude

Añade a tu claude_desktop_config.json :

"vibe-check": { "command": "node", "args": [ "/path/to/vibe-check-mcp/build/index.js" ], "env": { "GEMINI_API_KEY": "YOUR_GEMINI_API_KEY" } }

Configuración del entorno

Cree un archivo .env en la raíz del proyecto:

GEMINI_API_KEY=your_gemini_api_key_here

Guía de indicaciones para agentes

Para lograr interrupciones de patrón efectivas, incluya estas instrucciones en el indicador de su sistema:

As an autonomous agent, you will: 1. Treat vibe_check as a critical pattern interrupt mechanism 2. ALWAYS include the complete user request with each call 3. Specify the current phase (planning/implementation/review) 4. Use vibe_distill as a recalibration anchor when complexity increases 5. Build the feedback loop with vibe_learn to record resolved issues

Cuándo utilizar cada herramienta

HerramientaCuándo utilizarlo
🛑 comprobación de vibracionesCuando su agente comienza a explicar los fundamentos de blockchain para una aplicación de tareas pendientes
vibra_distillCuando el plan de su agente tiene más viñetas anidadas que toda su especificación técnica
🔄 vibra_aprenderDespués de haber guiado manualmente a su agente para que salga del abismo de la complejidad

Referencia de API

Consulte la Referencia técnica para obtener la documentación completa de la API.

Arquitectura

Vibe Check implementa una arquitectura metacognitiva de doble capa basada en principios de supervisión recursiva. Ideas clave:

  1. Resistencia a la inercia del patrón : los agentes LLM demuestran naturalmente una propiedad similar al impulso en sus caminos de razonamiento, lo que requiere una intervención externa para redirigirlos.
  2. Interrupciones de resonancia de fase : el cuestionamiento metacognitivo debe alinearse con la fase actual del agente (planificación/implementación/revisión) para lograr el máximo impacto correctivo.
  3. Integración de la estructura de autoridad : se debe instar explícitamente a los agentes a tratar la retroalimentación metacognitiva externa como interrupciones de alta prioridad en lugar de sugerencias opcionales.
  4. Mecanismos de compresión de anclajes : los flujos de razonamiento complejos deben destilarse en cadenas de anclaje mínimas que sirvan como puntos de recalibración efectivos.
  5. Bucles de retroalimentación recursivos : todos los errores observados deben almacenarse y aprovecharse para construir modelos de fallas longitudinales que mejoren la eficacia de las interrupciones.

Para obtener más detalles sobre los principios de diseño subyacentes, consulte Filosofía .

Vibe Check en acción (continuación)




Documentación

DocumentoDescripción
Estrategias de incitación de agentesTécnicas detalladas para la integración de agentes
Integración avanzadaEncadenamiento de retroalimentación, niveles de confianza y más
Referencia técnicaDocumentación completa de la API
FilosofíaLos principios de alineación de IA más profundos detrás de Vibe Check
Estudios de casoEjemplos reales de Vibe Check en acción

Contribuyendo

¡Agradecemos tus contribuciones a Vibe Check! Ya sea para corregir errores, añadir funciones o simplemente mejorar la documentación, consulta nuestras Pautas de Contribución para empezar.

Licencia

Instituto Tecnológico de Massachusetts (MIT)

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

Un sistema de interrupción de patrones metacognitivos que ayuda a evitar que los asistentes de IA empleen caminos de razonamiento demasiado complicados al proporcionar validación externa, orientación de simplificación y mecanismos de aprendizaje.

  1. What is Vibe Check?
    1. The Problem: Pattern Inertia
      1. Features: Metacognitive Oversight Tools
        1. 🛑 vibe_check
        2. ⚓ vibe_distill
        3. 🔄 vibe_learn
        4. Vibe Check in Action
      2. Installation & Setup
        1. Installing via Smithery
        2. Manual Installation via npm (Recommended)
      3. Integration with Claude
        1. Environment Configuration
          1. Agent Prompting Guide
            1. When to Use Each Tool
              1. API Reference
                1. Architecture
                  1. Vibe Check in Action (Continued)
                    1. Documentation
                      1. Contributing
                        1. License
                          ID: 0ubpv1yc35