Vibe Check MCP
用外部导师式反思中断智能体的思维锁定与过度设计。
按维度查看评分与理由
证据将能力限制为建议、会话规则和专用学习日志；安全文档明确说明不会执行命令或读取任意文件，HTTP 默认仅允许回环来源和主机，并设置请求体上限。向第三方 LLM 转发提示、日志位置、配置写入和网络暴露均有清楚说明；安装器采用原子写入、0600 权限、托管标记及备份，并有测试佐证回滚行为。依赖审计、CI 安全检查和 Hono 覆盖修复说明较完整，且诚实披露覆盖规则不会传递给下游包。扣分在于没有展示每次外传、写日志或修改客户端配置前的明确用户确认机制；敏感数据主要依赖“不要发送”的指导和可选禁用设置，路线图还承认输入清理尚未完成。作者、仓库、论文和许可证归属清楚；发布者注册身份未知本身不作负面推断。
README、包清单、CI 和测试对 Node 20、版本号、传输方式及安装行为大体一致，并展示了节点版本不足、无效配置和非托管条目冲突等可理解的错误信息。扣分是未提供锁文件、完整实现或实际运行结果，无法静态确认所有提供商和依赖的可用性；只有 Gemini 描述了一次降级重试。研究成效的“减少 41%”与后文约 83% 到 42% 的表述存在百分比和百分点混用，且“完全可用”等断言缺少本材料中的运行证据。
目标用户和适用场景定义明确，覆盖编码、模糊任务、高风险任务及长流程。文档清楚界定五个工具、不会执行代码、无内置 HTTP 身份验证、维护模式及尚未实现的输入清理和结构化输出。触发建议具体到规划后、重大或不可逆动作前，并给出约 10–20% 的中断剂量。Node 版本、环境变量、模型覆盖、stdio/HTTP、Docker，以及 Claude、Cursor、Windsurf、VS Code 和多操作系统配置路径均有详细适配说明，因此这些项目获得满分。
README 具有目录、快速开始、配置表、安全说明、工具选择和文档索引；安装命令、运行要求、客户端差异和卸载步骤充分。包名、MCP 名称、工具名及 2.9.0 版本在所给材料中稳定，MIT 正文与元数据一致。限制披露尤其具体，包括维护模式、无认证、提示注入风险、网络暴露和依赖覆盖范围。扣分是目录列出 Usage Examples 和 FAQ，但所给 README 未呈现对应完整章节；变更日志仅被引用而未提供，发布流程也只展示按标签生成说明。维护者虽具名且给出问题渠道，但项目已停止功能开发，安全报告所称的 package.json 邮箱在所给清单中并未出现。
该产品提供独立的第二模型审视、会话规则和可选经验记录，相比普通单代理流程具有明确的潜在增量价值，且给出了研究样本和效果主张。安装较轻量，并提出控制中断频率，但每次检查会引入额外模型调用，材料没有量化延迟、令牌或费用。主要扣分在输出可用性：路线图明确表示结构化输出仍未实现，目前核心建议似乎是非结构化文本，难以供下游代理稳定解析；论文与效果数据也未包含在源文件中供本次静态核验。
版本、依赖、安全控制、CI 命令和配置写入行为可在 README、SECURITY、package.json、工作流及测试之间交叉印证，尤其是原子写入、备份、权限和冲突处理。扣分是研究论文、架构文档、变更日志、审计输出和完整源实现均未提供，因此成效、模型兼容性、“审计干净”和运行期安全声明只能部分追溯。路线图能区分未来工作，但营销性的“企业就绪”“完全可用”和受信任表述未与可核验事实充分分离。
- 该服务会把完整用户请求及相关上下文发送给所配置的第三方 LLM；不要传入密钥、个人资料、专有代码或其他敏感信息，除非相应提供商和数据政策已获批准。
- HTTP 模式没有内置身份验证。若非仅绑定本机回环地址，应置于带身份验证的代理之后，并明确配置 MCP_ALLOWED_HOSTS 和 CORS_ORIGIN；不要使用通配符暴露到不可信网络。
- vibe_learn 会写入 ~/.vibe-check/vibe-log.json；部署前应确认禁用方式、保留期限、文件权限和清理流程。
- 下游安装该 npm 包时，仓库级 @hono/node-server override 不会自动生效；消费者需自行固定修复版本并审计实际依赖树。
- 核心反馈尚非结构化输出，且输入清理仍列在路线图中；不要把建议直接作为不可逆操作的自动授权，应由调用方实施验证和审批。
- 项目处于维护模式，只保证最新版本接收安全更新；采用前应规划依赖升级、模型名称变更及可能的社区接管路径。
这个 Agent 能做什么，适合哪些场景？
Vibe Check MCP 是一个自托管的 Model Context Protocol 服务器，为正在执行复杂或高风险任务的智能体增加外部元认知检查层。主智能体通过 `vibe_check` 提交完整用户请求与当前计划，服务器再调用第二个模型，生成用于质疑假设、暴露不确定性和调整行动方向的导师式反馈。其 Chain-Pattern Interrupt（CPI）机制可在风险升高或执行不可逆操作前插入暂停点，并能结合 `sessionId` 延续历史建议。服务器还提供可选的 `vibe_learn` 记录能力，以及用于设置、检查和清除会话规则的 constitution 工具。它以 Node.js 20+ 进程运行，可通过 STDIO 接入 MCP 客户端，也能以本地 HTTP 服务暴露 `/mcp` 和 `/healthz`；模型端支持 Gemini、OpenAI、OpenRouter 与 Anthropic。项目目前处于维护模式，最新维护版为 v2.9.0，只计划发布安全和缺陷修复。
端到端流程是：MCP 客户端启动服务器并向 vibe_check 传入目标、计划、完整请求及可选的 sessionId 或 modelOverride；服务器调用所选模型提供商的第二个模型，返回针对假设、风险和下一步行动的反思性反馈。使用 sessionId 时，它会汇总此前建议以维持上下文连续性；Gemini 调用失败时会重试一次 gemini-3.5-flash-lite，之后退回静态问题。vibe_learn 可记录已解决的错误、偏好和成功经验。update_constitution、check_constitution 与 reset_constitution 分别负责合并或设置、读取和清除每个会话的规则，供 CPI 干预层执行。运行边界是本地 Node.js MCP 服务器：STDIO 模式由客户端直接管理进程，HTTP 模式默认监听 2091 端口并提供健康检查及 JSON-RPC MCP 端点。
- 开发者让编码智能体进行大型重构时，在规划完成后及重大修改前调用
vibe_check，检查是否出现不必要的架构扩张。 - 团队让智能体处理需求含糊的任务时，把完整原始请求和当前计划交给第二个模型，寻找遗漏的约束或错误假设。
- 负责高风险自动化的工程师可在外部调用、数据写入或其他不可逆动作前插入 CPI 暂停点。
- 长期运行的工作流可复用同一
sessionId，让后续检查参考此前建议，而不是每次从零开始。 - 有明确操作政策的团队可用 session constitution 强制执行“禁止外网访问”或“重构前先运行单元测试”等会话规则。
- 同时使用多家模型服务的团队可按全局配置或单次
modelOverride在 Gemini、OpenAI、OpenRouter 和 Anthropic 之间选择。
这个 Agent 有哪些优点和局限？
- 采用独立的第二模型作为导师层，可在主智能体执行重大动作前主动质疑其计划，而不只是记录运行结果。
- 同时提供 STDIO 和流式 HTTP 两种 MCP 传输方式，并明确支持 Claude Desktop、Cursor、Windsurf 和 Visual Studio Code 的配置流程。
- 模型后端覆盖 Gemini、OpenAI、OpenRouter 和 Anthropic，既可设置全局默认值，也可通过
modelOverride按调用切换。 - 具备
sessionId历史连续性和 session constitution，可让多轮监督保留既往建议并执行会话级规则。 - HTTP 模式包含回环 CORS 默认值、Host 校验和可配置 JSON 请求体上限等具体防护。
- 项目已进入维护模式，不再进行主动功能开发；路线图中的结构化
vibe_check输出、通用重试与输入净化仍不是已完成能力。 - 每次有效检查通常需要调用第二个外部模型，因此会增加网络依赖、提供商费用、延迟以及向该提供商发送任务上下文的隐私考量。
- 要求 Node.js 20+，并需要 MCP 客户端配置或运行一个 HTTP 服务，不是无需基础设施的内置智能体功能。
- HTTP 升级到 v2.9.0 后，非本地主机部署必须显式配置
MCP_ALLOWED_HOSTS，否则会出现 403，形成迁移步骤。 - README 报告了 CPI 的研究结果，但没有提供针对每种模型、代码库规模或生产环境的独立效果保证。
如何安装或部署这个 Agent？
需要 Node.js 20 或更高版本及 npm。无需本地安装即可运行 STDIO 服务器：
npx -y @pv-bhat/vibe-check-mcp start --stdio在 MCP 客户端配置中加入：
{
"mcpServers": {
"vibe-check-mcp": {
"command": "npx",
"args": ["-y", "@pv-bhat/vibe-check-mcp", "start", "--stdio"]
}
}
}
至少配置一个计划使用的提供商密钥，例如 GEMINI_API_KEY、OPENAI_API_KEY、OPENROUTER_API_KEY 或 ANTHROPIC_API_KEY。可用 DEFAULT_LLM_PROVIDER=gemini|openai|openrouter|anthropic 选择默认提供商，并按需设置 DEFAULT_MODEL。如需从源码开发：
git clone https://github.com/PV-Bhat/vibe-check-mcp-server.git
cd vibe-check-mcp-server
npm ci
npm run build
npm test如何使用这个 Agent？
在智能体系统提示中要求其在规划后及重大或不可逆操作前调用 vibe_check，并始终传入完整用户请求和当前计划。可按单次请求指定模型，例如：
{ "goal": "...", "plan": "...", "modelOverride": { "provider": "anthropic", "model": "claude-opus-5" } }
需要连续上下文时复用同一 sessionId；修正错误后可选择调用 vibe_learn。会话规则分别通过 update_constitution({ sessionId, rules })、check_constitution({ sessionId }) 和 reset_constitution({ sessionId }) 管理。手动检查 HTTP 模式可运行 npx -y @pv-bhat/vibe-check-mcp start --http --port 2091，再访问 http://127.0.0.1:2091/healthz；JSON-RPC 请求发送到 http://127.0.0.1:2091/mcp。若通过非回环主机、Docker 或反向代理部署 v2.9.0，必须把该主机名加入 MCP_ALLOWED_HOSTS，否则请求会收到 HTTP 403。
常见问题
使用它会产生额外模型费用吗？
必须使用 Gemini 吗？
modelOverride 切换。模型服务失败时会怎样？
gemini-3.5-flash-lite 重试一次，之后回退到静态问题。路线图仍把更通用的指数退避重试列为未来工作。