Vibe Check MCP

振动检查MCP

该项目已不再积极维护。 v2.8.0是最终版本，其中包括安全补丁和错误修复。服务器仍然完全正常工作。在MIT许可下，欢迎社区分叉和贡献。

KISS overzealous agents goodbye. Plug & play agent oversight tool.

Based on research:

In our study agents calling Vibe Check improved success +27% and halved harmful actions -41%

Featured on PulseMCP “Most Popular (This Week)” • 5k+ monthly calls on Smithery.ai • research-backed oversight • STDIO + streamable HTTP transport

*即插即用导师层，防止代理过度工程，并将其保持在最小可行路径上——研究支持的MCP服务器，使LLM保持对齐、反射和安全。*

Trusted by developers across MCP platforms and registries

快速入门（npx）

直接从npm运行服务器，无需本地安装。需要节点 >=20。选择运输方式：

选项1——通过STDIO的MCP客户端

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

• 从支持MCP的客户端（Claude Desktop、Cursor、Windsurf等）启动。
• [MCP] stdio transport connected 表示进程正在等待客户端。
• 将此块添加到您的客户端配置中，以便生成以下命令：

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

选项2–手动HTTP检查

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

• curl http://127.0.0.1:2091/health 确认服务已上线。
• 将JSON-RPC请求发送到 http://127.0.0.1:2091/rpc.

npx按需下载这两个选项的软件包。有关详细的客户端设置和其他命令，如 install 和 doctor，请参阅下面的文档。

认可

• 刊登在PulseMCP“本周最受欢迎”头版（2025年10月13日当周） 🔗
• 在Anthropic的官方模型上下文协议仓库中列出 🔗
• 可在MCP官方注册表中找到 🔗
• Sean Kochel为vibe程序员设计的九大MCP服务器 🔗

目录

• 快速入门（npx）
• 什么是Vibe Check MCP？
• 概述
• 问题：模式惯性和推理锁定
• 主要特点
• 新增功能
• 开发设置
• 发布
• 用法示例
• 适应性元认知中断（CPI）
• 代理提示要点
• 何时使用每种工具
• 文档
• 研究与哲学
• 安全
• 路线图
• 贡献者和社区
• 常见问题解答
• 上市
• 学分和许可证

______________________________________________________________________

什么是Vibe Check MCP？

Vibe Check MCP使代理保持在最小可行路径上，只有在证据需要时才会增加复杂性。Vibe Check MCP-是一个轻量级服务器，实现了Anthropic的 模型上下文协议.它充当一个 人工智能元导师 对于你的代理人来说，用以下方式打断模式惯性 链模式中断（CPI） 以防止推理锁定（RLI）。将其视为LLM的橡皮鸭调试器——在代理走上错误的道路之前进行快速的健全性检查。

概述

Vibe Check MCP将元认知信号层与CPI配对，以便代理可以在风险飙升时暂停。Vibe检查表面特征、不确定性和风险评分；CPI消耗这些触发器，并在代理恢复之前执行干预策略。看 CPI整合指南 CPI回购https://github.com/PV-Bhat/cpi了解接线细节。

Vibe Check调用第二个LLM，向您的主代理提供元认知反馈。将vibe_check调用集成到代理系统提示中，并在不可逆操作之前指示工具调用，可以显著提高代理的一致性和常识。高级组件图： docs/architecture.md，而CPI切换图和示例垫片在 docs/integrations/cpi.md.

问题：模式惯性和推理锁定

大型语言模型可以自信地遵循有缺陷的计划。如果没有外部推动，它们可能会陷入过度工程或错位。Vibe Check提供了短暂的反射暂停，提高了可靠性和安全性。

主要特点

v2.8.0（最终维护版本）的新增功能

维修通知： 该项目已不再积极维护。它仍然功能齐全，并在麻省理工学院许可下可用。社区分叉是受欢迎的。有关详细信息，请参阅 更新日志.

• Bug修复： check_constitution 现在返回有效的MCP内容类型（修复#84）
• 安全： 所有依赖项都已更新——解决了14个npm审计漏洞（axios、MCP SDK、diff、express和transmitive deps）
• MCP SDK 1.26： 更新到最新的SDK，修复了关键的跨客户端数据泄漏问题；HTTP传输适配器已更新以实现兼容性

会议章程（按会议规则）

使用轻量级的“宪法”来执行规则 sessionId CPI将兑现这一承诺。例如，构造规则：“没有外部网络调用”，“在重构之前更喜欢单元测试”，“永远不要将机密写入磁盘。”

API（工具）：

• update_constitution({ sessionId, rules }) → 合并/设置会话的规则集
• reset_constitution({ sessionId }) → 清除会话规则
• check_constitution({ sessionId }) → 返回会话的有效规则

开发设置

# Clone and install
git clone https://github.com/PV-Bhat/vibe-check-mcp-server.git
cd vibe-check-mcp-server
npm ci
npm run build
npm test

使用 npm 适用于所有工作流(npm ci, npm run build, npm test).此项目针对Node >=20.

创建一个 .env 带有您计划使用的API密钥的文件：

# Gemini (default)
GEMINI_API_KEY=your_gemini_api_key
# Optional providers / Anthropic-compatible endpoints
OPENAI_API_KEY=your_openai_api_key
OPENROUTER_API_KEY=your_openrouter_api_key
ANTHROPIC_API_KEY=your_anthropic_api_key
ANTHROPIC_AUTH_TOKEN=your_proxy_bearer_token
ANTHROPIC_BASE_URL=https://api.anthropic.com
ANTHROPIC_VERSION=2023-06-01
# Optional overrides
# DEFAULT_LLM_PROVIDER accepts gemini | openai | openrouter | anthropic
DEFAULT_LLM_PROVIDER=gemini
DEFAULT_MODEL=gemini-2.5-pro

配置

看 docs/TEST.md 有关如何运行测试的说明。

码头工人

该存储库包含一个用于一个命令设置的辅助脚本。

bash scripts/docker-setup.sh

看 了解全部细节。

提供者密钥

看 API密钥与秘密管理 对于支持的提供商、解析顺序、存储位置和安全指导。

运输选择

CLI支持stdio和HTTP传输。传输分辨率遵循以下顺序：显式标志(--stdio/--http) → MCP_TRANSPORT → 默认 stdio。使用HTTP时，请指定 --port （或设置 MCP_HTTP_PORT)；默认端口为 2091。生成的条目添加 --stdio 或 --http --port 因此，支持HTTP的客户端也会收到 http://127.0.0.1: 终点。

客户端安装程序

每个安装程序都是幂等的，并用 "managedBy": "vibe-check-mcp-cli"。在应用更改之前，每次运行都会写入一次备份，合并是原子性的(*.bak 文件使回滚变得容易）。看 docs/clients.md 以获取更深入的客户特定参考。

克劳德桌面

• 配置路径： claude_desktop_config.json （每个平台自动发现）。
• 默认传输：stdio(npx … start --stdio).
• 安装后重新启动Claude Desktop以加载新的MCP服务器。
• 如果已存在非托管条目 vibe-check-mcp，CLI保持不变并打印警告。

光标

• 配置路径： ~/.cursor/mcp.json （提供 --config 如果你把它存放在别处）。
• 模式反映了克劳德的 mcpServers 布局。
• 如果文件丢失，CLI会为Cursor的设置面板打印一个准备粘贴的JSON块，而不是失败。

风浪（喀斯喀特）

• 配置路径：旧版 ~/.codeium/windsurf/mcp_config.json，新建使用 ~/.codeium/mcp_config.json.
• 通过 --http 发出一个条目 serverUrl Windsurf的HTTP客户端。
• 现有哨兵管理 serverUrl 条目被保留并更新到位。

Visual Studio Code

• 工作区配置位于 .vscode/mcp.json；配置文件也会存储 mcp.json 在您的VS Code用户数据目录中。
• 提供 `--config

以工作区文件为目标。没有 --config，CLI打印一个JSON代码段和一个 vscode:mcp/install?...` 您可以直接从终端打开链接。

• VS Code支持可选的dev字段；通过 --dev-watch 和 --dev-debug 填充 dev.watch/dev.debug.

卸载并回滚

• 还原安装过程中生成的备份（最新 *.bak 在您的配置旁边）立即恢复。
• 要手动删除服务器，请删除 vibe-check-mcp 进入下 mcpServers （克劳德/风帆/光标）或 servers （VS代码），只要它仍然被标记为 "managedBy": "vibe-check-mcp-cli".

研究与哲学

CPI（链模式中断） 是Vibe Check背后的研究支持的监督方法。它在风险转折时刻注入短暂、适时的“暂停点”，使代理重新与用户的真正优先级对齐，防止破坏性的级联和 推理锁定在153次运行的汇总评估中，CPI 成功率几乎翻了一番（约27%→54%），有害行为大约减半（约83%→42%）最佳中断 剂量约为10-20% 步。 *Vibe Check MCP在测试时将CPI作为外部指导层来实现。*

链接：

• 📄 CPI论文（ResearchGate） — http://dx.doi.org/10.13140/RG.2.2.18237.93922
• 📘 CPI参考实现（GitHub）: https://github.com/PV-Bhat/cpi
• 📚 MURST Zenodo DOI（RSRC档案）: https://doi.org/10.5281/zenodo.14851363

flowchart TD
  A[Agent Phase] --> B{Monitor Progress}
  B -- high risk --> C[CPI Interrupt]
  C --> D[Reflect & Adjust]
  B -- smooth --> E[Continue]

代理提示要点

在代理人的系统提示中，明确指出 vibe_check 是反思的必备工具。始终传递完整的用户请求和其他相关上下文。纠正错误后，您可以选择使用 vibe_learn 为未来的分析建立历史。

示例片段：

As an autonomous agent you will:
1. Call vibe_check after planning and before major actions.
2. Provide the full user request and your current plan.
3. Optionally, record resolved issues with vibe_learn.

何时使用每种工具

文档

• 代理人激励策略
• CPI集成
• 高级集成
• 技术参考
• 哲学
• 案例研究
• 更新日志

安全

此存储库包括一个基于CI的安全扫描，该扫描在每个拉取请求上运行。它检查依赖关系 npm audit 并扫描源以寻找危险模式。看 安全.md 了解详细信息以及如何报告问题。

路线图

注： 此项目已达到最终维护版本（v2.8.0）。下面的路线图是为可能希望继续开发的社区分支保留的。

• 结构化输出 vibe_check: 返回一个JSON信封，例如 { advice, riskScore, traits } 因此，下游代理可以确定性地推理。
• LLM弹性： 包裹 generateResponse 重试和指数回退。
• 输入净化： 验证和清理工具参数，以减轻提示注入向量。
• 快速外化： 将硬编码的提示移动到配置文件中，以提高透明度和可审计性（见PR#71）。

贡献者和社区

欢迎投稿！看 贡献.md.

链接

• MSEEP
• MCP服务器
• MCP.so
• 创建.ai
• 脉冲MCP
• Playbooks.com
• MCPHub.tools
• MCP目录

学分和许可证

Vibe Check MCP在以下情况下发布 MIT许可证。专为可靠、企业就绪的人工智能代理而构建。

作者署名和链接

Vibe Check MCP由以下人员创建： 普鲁特维·巴特，倡议-https://murst.org/