Vibe Check

by PV-Bhat

496 stars

614 downloads

Not rated

GitHub Website

About

The definitive Vibe Coder's sanity check MCP server: Prevents cascading errors by calling a "Vibe-check" agent to ensure alignment and prevent scope creep

Details

Author: PV-Bhat
GitHub stars: 496
Downloads: 614
Categories: Developer Tools, Community, Other, Automation, AI

- CPI adaptive interrupts that challenge assumptions and keep agents aligned.
- Multi-provider LLM support: Gemini, OpenAI, Anthropic, and OpenRouter.
- History continuity: summarizes prior advice when a sessionId is supplied.
- Optional vibe_learn logs mistakes and fixes for future reflection.
- Session constitution: enforce per-session rules via update_constitution, reset_constitution, and check_constitution tools.
- Research-backed with published results; listed in Anthropic’s official MCP repo and MCP Registry.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Vibe Check

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

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

JSON

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

JSON

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

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

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

JSON

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

JSON

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

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

From the repository

Run directly via npx with npx -y @pv-bhat/vibe-check-mcp start --stdio for MCP clients or --http --port 2091 for manual HTTP inspection. Requires Node >=20. Add the appropriate command block to your MCP client config. Optionally set API keys in a .env file (Gemini, OpenAI, Anthropic, or OpenRouter) and provide a sessionId for history continuity.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

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

McpServers

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

Vibe Check MCP

> This project is in maintenance mode. Active feature development has ended; only maintenance patches (security and bug fixes) are published. v2.8.1 is the latest maintenance release. The server remains fully functional. Community forks and contributions are welcome under the MIT license.

<p align="center"><b>KISS overzealous agents goodbye. Plug & play agent oversight tool.</b></p>

<p align="center">
<b>Based on research:</b><br/>
In our study agents calling Vibe Check improved success +27% and halved harmful actions -41%
</p>

<p align="center">
<a href="https://www.researchgate.net/publication/394946231_Do_AI_Agents_Need_Mentors_Evaluating_Chain-Pattern_Interrupt_CPI_for_Oversight_and_Reliability?channel=doi&linkId=68ad6178ca495d76982ff192&showFulltext=true">

</a>
<a href="https://github.com/modelcontextprotocol/servers"></a>
<a href="https://registry.modelcontextprotocol.io/"></a>
<a href="https://www.pulsemcp.com/servers/pv-bhat-vibe-check">
!PulseMCP: Most Popular (this week)-0b7285?style=flat-square)
</a>
<a href="https://github.com/PV-Bhat/vibe-check-mcp-server/actions/workflows/ci.yml"></a>
<a href="LICENSE"></a>
</p>

<p align="center">
<sub> Featured on PulseMCP “Most Popular (This Week)” • 5k+ monthly calls on Smithery.ai • research-backed oversight • STDIO + streamable HTTP transport</sub>
</p>

Gemini_Generated_Image_kvdvp4kvdvp4kvdv

Plug-and-play mentor layer that stops agents from over-engineering and keeps them on the minimal viable path — research-backed MCP server keeping LLMs aligned, reflective and safe.

<div align="center">
<a href="https://github.com/PV-Bhat/vibe-check-mcp-server">
GitHub
</a>
  
<a href="https://registry.modelcontextprotocol.io">
Anthropic MCP Registry
</a>
  
<a href="https://smithery.ai/server/@PV-Bhat/vibe-check-mcp-server">

</a>
  
<a href="https://www.pulsemcp.com/servers/pv-bhat-vibe-check">

</a>
</div>

<div align="center">
<em>Trusted by developers across MCP platforms and registries</em>
</div>

Quickstart (npx)

Run the server directly from npm without a local installation. Requires Node >=20. Choose a transport:

Option 1 – MCP client over STDIO

npx -y @pv-bhat/vibe-check-mcp start --stdio

- Launch from an MCP-aware client (Claude Desktop, Cursor, Windsurf, etc.).
- [MCP] stdio transport connected indicates the process is waiting for the client.
- Add this block to your client config so it spawns the command:

{
  "mcpServers": {
    "vibe-check-mcp": {
      "command": "npx",
      "args": ["-y", "@pv-bhat/vibe-check-mcp", "start", "--stdio"]
    }
  }
}

Option 2 – Manual HTTP inspection

npx -y @pv-bhat/vibe-check-mcp start --http --port 2091

- curl http://127.0.0.1:2091/health to confirm the service is live.
- Send JSON-RPC requests to http://127.0.0.1:2091/rpc.

npx downloads the package on demand for both options. For detailed client setup and other commands like install and doctor, see the documentation below.

Recognition

- Featured on PulseMCP “Most Popular (This Week)” front page (week of 13 Oct 2025) 🔗 - Listed in Anthropic’s official Model Context Protocol repo 🔗 - Discoverable in the official MCP Registry 🔗 - Featured on Sean Kochel's Top 9 MCP servers for vibe coders 🔗

- Quickstart (npx) - What is Vibe Check MCP? - Overview - The Problem: Pattern Inertia & Reasoning Lock-In - Key Features - What's New - Development Setup - Release - Usage Examples - Adaptive Metacognitive Interrupts (CPI) - Agent Prompting Essentials - When to Use Each Tool - Documentation - Research & Philosophy - Security - Roadmap - Contributors & Community - FAQ - Listed on - Credits & License ---

What is Vibe Check MCP?

Vibe Check MCP keeps agents on the minimal viable path and escalates complexity only when evidence demands it. Vibe Check MCP is a lightweight server implementing Anthropic's Model Context Protocol. It acts as an AI meta-mentor for your agents, interrupting pattern inertia with Chain-Pattern Interrupts (CPI) to prevent Reasoning Lock-In (RLI). Think of it as a rubber-duck debugger for LLMs – a quick sanity check before your agent goes down the wrong path.

Overview

Vibe Check MCP pairs a metacognitive signal layer with CPI so agents can pause when risk spikes. Vibe Check surfaces traits, uncertainty, and risk scores; CPI consumes those triggers and enforces an intervention policy before the agent resumes. See the CPI integration guide and the CPI repo at https://github.com/PV-Bhat/cpi for wiring details.

Vibe Check invokes a second LLM to give meta-cognitive feedback to your main agent. Integrating vibe_check calls into agent system prompts and instructing tool calls before irreversible actions significantly improves agent alignment and common-sense. The high-level component map: docs/architecture.md, while the CPI handoff diagram and example shim are captured in docs/integrations/cpi.md.

The Problem: Pattern Inertia & Reasoning Lock-In

Large language models can confidently follow flawed plans. Without an external nudge they may spiral into overengineering or misalignment. Vibe Check provides that nudge through short reflective pauses, improving reliability and safety.

Key Features

| Feature | Description | Benefits |
|---------|-------------|----------|
| CPI Adaptive Interrupts | Phase-aware prompts that challenge assumptions | alignment, robustness |
| Multi-provider LLM | Gemini, OpenAI, Anthropic, and OpenRouter support | flexibility |
| History Continuity | Summarizes prior advice when sessionId is supplied | context retention |
| Optional vibe_learn | Log mistakes and fixes for future reflection | self-improvement |

What's New in v2.8.1 (Maintenance Release)

> Maintenance Notice: This project is in maintenance mode and is no longer under active feature development. It remains fully functional and available under the MIT license. Community forks are welcome. For details, see the Changelog.

- npm release: v2.8.0 was never published to npm; v2.8.1 ships all of its fixes to the registry, including everything below
- Bug fix (v2.8.0): check_constitution now returns valid MCP content types (fixes #84)
- Security (v2.8.0): All dependencies updated — resolves 14 npm audit vulnerabilities (axios, MCP SDK, diff, express, and transitive deps)
- MCP SDK 1.26 (v2.8.0): Updated to latest SDK with critical cross-client data leakage fix; HTTP transport adapter updated for compatibility
- Housekeeping: registry metadata (server.json, smithery.yaml, CITATION.cff) re-synced to the release version, dev-only vitest advisory cleared, GitHub Releases automated on tag push

Session Constitution (per-session rules)

Use a lightweight “constitution” to enforce rules per sessionId that CPI will honor. Eg. constitution rules: “no external network calls,” “prefer unit tests before refactors,” “never write secrets to disk.”

API (tools):
- update_constitution({ sessionId, rules }) → merges/sets rule set for the session
- reset_constitution({ sessionId }) → clears session rules
- check_constitution({ sessionId }) → returns effective rules for the session

Development Setup

```bash

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

Vibe Check MCP

Quickstart (npx)

Option 1 – MCP client over STDIO

Option 2 – Manual HTTP inspection

Recognition

Table of Contents

What is Vibe Check MCP?

Overview

The Problem: Pattern Inertia & Reasoning Lock-In

Key Features

What's New in v2.8.1 (Maintenance Release)

Session Constitution (per-session rules)

Development Setup

Install

More like this

Sequential Thinking

Sentry

Github

Filesystem

EverArt

Google Drive