/ 目錄 / 演練場 / vibe-check-mcp-server
● 社群 PV-Bhat ⚡ 即開即用

vibe-check-mcp-server

作者 PV-Bhat · PV-Bhat/vibe-check-mcp-server

第二个 LLM,在代理执行前质疑其计划——抓住视野狭隘、过度工程化、推理死锁。

vibe-check-mcp (PV-Bhat) 通过链式模式中断 (CPI) 向代理提供元认知反馈。在关键决策点调用第二个模型来推翻假设。项目处于维护模式 (v2.8.0 最终版) 但在 MIT 许可下完全可用。

為什麼要用

核心特性

即時演示

實際使用效果

vibe-check.replay ▶ 就緒
0/0

安裝

選擇你的客戶端

~/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
    }
  }
}

開啟 Claude Desktop → Settings → Developer → Edit Config。儲存後重啟應用。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "vibe-check": {
      "command": "npx",
      "args": [
        "-y",
        "vibe-check-mcp-server"
      ],
      "_inferred": true
    }
  }
}

Cursor 使用與 Claude Desktop 相同的 mcpServers 格式。專案級設定優先於全域。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "vibe-check": {
      "command": "npx",
      "args": [
        "-y",
        "vibe-check-mcp-server"
      ],
      "_inferred": true
    }
  }
}

點擊 Cline 側欄中的 MCP Servers 圖示,然後選 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "vibe-check": {
      "command": "npx",
      "args": [
        "-y",
        "vibe-check-mcp-server"
      ],
      "_inferred": true
    }
  }
}

格式與 Claude Desktop 相同。重啟 Windsurf 生效。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "vibe-check",
      "command": "npx",
      "args": [
        "-y",
        "vibe-check-mcp-server"
      ]
    }
  ]
}

Continue 使用伺服器物件陣列,而非映射。

~/.config/zed/settings.json
{
  "context_servers": {
    "vibe-check": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "vibe-check-mcp-server"
        ]
      }
    }
  }
}

加入 context_servers。Zed 儲存後熱重載。

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

一行命令搞定。用 claude mcp list 驗證,claude mcp remove 移除。

使用場景

實戰用法: vibe-check-mcp-server

在使用 vibe-check 进行破坏性操作前检查计划的理智性

👤 任何运行具有写入权限的代理的人 ⏱ ~10 min beginner

何時使用: 代理即将删除文件、运行迁移或部署——你想要第二意见。

步驟
  1. 对计划调用 vibe_check
    运行迁移前,对这个计划调用 vibe_check:[粘贴]。什么可能出错?✓ 已複製
    → 推翻列表:未检查的假设、缺失的回滚、范围蔓延
  2. 明确解决或忽略每个关切
    处理每个关切——要么缓解,要么明确地作为超出范围而驳回。✓ 已複製
    → 带注释的计划准备好运行

結果: 破坏性操作后较少出现'哦不'的时刻。

注意事項
  • 代理以橡皮图章风格驳回所有关切 — 要求代理重新阐述每个关切和具体的缓解措施
搭配使用: sequentialthinking-tools

使用 vibe-check 的 constitution 执行会话规则

👤 共享代理工作流的团队 ⏱ ~10 min intermediate

何時使用: 你想要某些规则(永远不要推送到主分支、总是先写测试)在整个会话中执行。

步驟
  1. 设置 constitution
    使用 update_constitution 为这个会话设置这些规则:[列表]。通过 CPI 在每个可能违反它们的工具调用上执行。✓ 已複製
    → 规则已确认;随后的违反会被中断
  2. 有疑问时检查
    调用 check_constitution 查看当前有效的规则。✓ 已複製
    → 当前规则列表

結果: 在会话中保持一致的代理行为,无需在每条消息中重复规则。

使用 vibe_learn 从代理错误中捕获教训

👤 迭代提示的代理开发人员 ⏱ ~5 min beginner

何時使用: 代理犯了一个经典错误;你想让它不要重复。

步驟
  1. 记录教训
    调用 vibe_learn:mistake='deleted prod table without snapshot'、lesson='always take a snapshot before DDL on prod'。✓ 已複製
    → 课程为会话存储
  2. 稍后依赖它
    (稍后在同一会话中)尝试 DDL——vibe_check 显示存储的课程✓ 已複製
    → 用相关的过去课程中断

結果: 会话内的'不要再这样做'的记忆,无需提示工程。

組合

與其他 MCP 搭配,撬動十倍槓桿

计划 + 推翻循环

使用 sequentialthinking_tools 制定计划,然后在执行步骤 1 前对计划调用 vibe_check。✓ 已複製
vibe-check + overture

可视化计划 + vibe-check 层

在 Overture 生成计划图后,对其运行 vibe_check 并将关切作为注释显示。✓ 已複製

工具

此 MCP 暴露的能力

工具輸入參數何時呼叫成本
vibe_check plan: str, context?: str 在任何非平凡或不可逆操作之前 通过你配置的提供商进行 1 次 LLM 调用
vibe_learn mistake: str, lesson: str 错误发生后立即调用,趁记忆犹新 0
update_constitution rules: str[] 会话开始或政策更改 0
check_constitution 调试意外中断 0
reset_constitution 重新开始 0

成本與限制

運行它的成本

API 配額
使用你选择的 LLM 的配额
每次呼叫 Token 數
vibe_check 的 500-3000 个
費用
仅 LLM 令牌成本
提示
仅对实质计划调用 vibe_check——跳过琐碎编辑可以节省令牌

安全

權限、密鑰、影響範圍

憑證儲存: 环境中的 LLM API 密钥 (OPENAI_API_KEY、ANTHROPIC_API_KEY 等)
資料出站: 仅发送给你配置的 LLM 提供商

故障排查

常見錯誤與修復

vibe_check 返回空关切

计划输入太模糊——包含具体步骤和副作用

代理忽略 vibe_check 输出

使系统提示要求在继续前处理每个关切

npx 找不到 @pv-bhat/vibe-check-mcp

发布的范围是 @pv-bhat;明确固定最新版本:npx -y @pv-bhat/vibe-check-mcp@latest

替代方案

vibe-check-mcp-server 對比其他方案

替代方案何時用它替代權衡
sequentialthinking-tools你想要计划,而不是推翻形状不同——没有对抗性的第二个模型
overture你想要可视化把关而不是文本推翻更复杂的设置

更多

資源

📖 閱讀 GitHub 上的官方 README

🐙 查看未解決的 issue

🔍 瀏覽全部 400+ MCP 伺服器和 Skills