/ 目录 / 演练场 / vibe-check-mcp-server
● 社区 PV-Bhat ⚡ 即开即用

vibe-check-mcp-server

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

一个第二 LLM,在执行前质疑你的 agent 计划——抓住思维定势、过度工程化、推理锁定。

vibe-check-mcp (PV-Bhat) 通过链式模式中断 (CPI) 为 agent 提供元认知反馈。在关键决策点调用第二个模型来质疑假设。项目处于维护模式 (v2.8.0 final),但在 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 检查计划的合理性

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

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

步骤
  1. 在计划上调用 vibe_check
    运行迁移前,在这个计划上调用 vibe_check: [粘贴]。可能出什么问题?✓ 已复制
    → 反馈列表:未检查的假设、缺失的回滚、范围蔓延
  2. 明确地解决或忽略每个关注点
    处理每个关注点——要么减轻,要么明确驳回为超出范围。✓ 已复制
    → 带注释的计划准备好运行

结果: 执行破坏性操作后更少出现'糟糕'的时刻。

注意事项
  • Agent 以橡皮图章方式驳回所有关注点 — 要求 agent 重述每个关注点和具体的缓解措施
搭配使用: sequentialthinking-tools

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

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

何时使用: 你想要某些规则(从不推送到 main、始终先编写测试)在整个会话中得到强制执行。

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

结果: 在会话内保持一致的 agent 行为,无需每条消息都重复规则。

用 vibe_learn 从 agent 的错误中获取经验教训

👤 迭代 prompt 的 agent 开发者 ⏱ ~5 min beginner

何时使用: Agent 犯了经典错误;你想要它不重复。

步骤
  1. 记录经验教训
    调用 vibe_learn: mistake='未经快照直接删除生产表',lesson='在生产环境 DDL 前总是进行快照'。✓ 已复制
    → 为会话存储的经验教训
  2. 稍后依赖它
    (同一会话稍后)尝试 DDL——vibe_check 浮出存储的经验教训✓ 已复制
    → 用相关的过去经验教训中断

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

组合

与其他 MCP 搭配,撬动十倍杠杆

计划 + 反馈循环

使用 sequentialthinking_tools 进行计划,然后在执行步骤 1 之前在计划上调用 vibe_check。✓ 已复制
vibe-check + overture

可视化计划 + vibe-check 层

在 Overture 生成计划图后,在其上运行 vibe_check 并将关注点作为注释浮出。✓ 已复制

工具

此 MCP 暴露的能力

工具输入参数何时调用成本
vibe_check plan: str, context?: str 在任何非平凡或不可逆的操作之前 1 LLM call via your configured provider
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 token 成本
提示
只在实质性计划上进行 vibe_check——在琐碎的编辑上跳过它可以节省 token

安全

权限、密钥、影响范围

凭据存储: 环境变量中的 LLM API 密钥(OPENAI_API_KEY、ANTHROPIC_API_KEY 等)
数据出站: 仅到你配置的 LLM 提供商

故障排查

常见错误与修复

vibe_check 返回空的关注点

计划输入过于模糊——包括具体的步骤和副作用

Agent 忽略 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