Vibe Check MCP

社区

KISS 过度热情的 AI 代理再见：即插即用的代理监督工具。

分类: 开发工具第 74 / 438
Stars: ★ 502 非常热门
传输方式: stdio（本地进程） · Streamable HTTP
运行环境: Node.js >=20
凭据: 可选 API Key
许可证: MIT
最近提交: 2 个月前
工具数: 5

63FMRS · C

Vibe Check MCP 提供了一个独特的元认知监督层，具有研究支持的 CPI 方法。它易于集成（npx + MCP 客户端），并支持多提供商 LLM。然而，该服务器处于维护模式，仅提供安全/错误修复，且使用外部 LLM 引入成本/隐私考虑。

最强项 · 安装易用性 14/20 最弱项 · 可靠性 10/20

可靠性

10/20

安全与权限

12/20

维护活跃度

13/20

文档质量

14/20

安装易用性

14/20

查看各项评分依据

可靠性 10/20: 证据：server.json与README一致声明了stdio和HTTP传输，工具列表包括vibe_check、vibe_learn及constitution相关工具。但README提到高级功能（如vibe_learn、constitution）和CPI集成，而实际工具列表和实现细节未在提供的源码中验证。当前维护模式表明可能不再积极修复bug。未提供实际执行证据（CI日志、测试结果）来确认服务器能干净启动并完成MCP握手。因此可靠性得分不超过12，因为缺乏直接执行验证。扣除：无法验证工具声明与实际行为是否完全一致；无CI日志或测试运行证据。
安全与权限 12/20: 证据：README详细说明了HTTP传输的加固措施（CORS默认loopback、Host头验证、请求体大小限制）。API密钥通过环境变量管理，并在文档中声明为秘密。未发现恶意行为、凭证窃取或不可逆操作的默认执行。但此静态审查未执行代码，无法验证这些安全控制是否实际实施。此外，存在提示注入风险（输入消毒未实现，如README路线图所示）。得分12，因为安全措施已记录但未经验证，且存在一些未缓解的风险（如提示注入）。扣除：无实际代码验证，安全控制仅文档声明；输入消毒未实现。
维护活跃度 13/20: 证据：仓库活跃，有503颗星和3个开放问题，维护模式声明（2025年后仅维护补丁）。存在MIT许可证，明确的安全报告渠道（SECURITY.md）。依赖更新记录在v2.9.0更新说明中。但该模式表明功能开发已停止，可能影响长期维护。此外，未提供发布日期或提交频率的详细信息。得分13，因为虽然维护活跃且有许可证和安全政策，但维护模式限制未来发展。扣除：未提供提交/发布频率的具体证据。
文档质量 14/20: 证据：README极其全面，涵盖安装、提供商、模型、传输、客户端配置、Docker、安全、路线图、FAQ等。文档链接丰富，如docs/architecture.md、docs/integrations/cpi.md、docs/changelog.md。包含了环境变量表、配置选项和故障排除提示。但有些文档链接可能是空的（如docs/TESTING.md链接未提供有效路径），且未明确说明所有限制和成本信息。得分14，因为文档质量高但存在一些空白链接和可能的成本信息缺失。扣除：某些文档链接可能无效；缺少明确的成本讨论。
安装易用性 14/20: 证据：提供npx快速启动命令，支持stdio和HTTP传输，并提供客户端配置示例（Claude Desktop等）。要求Node >=20，并有自动Docker设置脚本。但未提供实际验证的CI测试或安装测试结果，因此得分不超过15。得分14，因为安装步骤清晰，但依赖Node版本和外部API密钥可能增加复杂度。扣除：未验证安装过程；环境变量配置可能较多。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络

适合谁

需要额外监督的 AI 代理开发者和团队，以防止推理锁定和过度设计。
使用 MCP 客户端（如 Claude Desktop、Cursor）进行长时间或复杂代理工作流的用户。
寻求研究支持的代理可靠性改进的开发者。

不适合谁

无需外部监督的简单/快速任务（增加开销）。
对多提供商 LLM API 支持无关紧要的场景（默认需要 Gemini 密钥）。
需要官方支持或活跃功能开发的项目（当前处于维护模式）。

所需权限

需要至少一个 LLM 提供商的 API 密钥（如 Gemini、OpenAI、OpenRouter 或 Anthropic）。
HTTP 模式监听网络端口；建议限制为 loopback。
可以写入客户端配置文件（如 Claude Desktop、Cursor、Windsurf、VS Code）以进行安装。

风险与副作用

使用外部 LLM API 会发送提示上下文，可能涉及隐私或数据泄露。
使用 HTTP 模式并允许非 loopback 访问可能增加安全风险；v2.9.0 引入了主机验证和 CORS 加固。
过度使用 `vibe_check` 可能会减慢代理执行速度；最佳中断剂量约为步骤的 10-20%。

安装接入

准备工作

运行环境：Node.js >=20

GEMINI_API_KEY 可选密钥 Google AI Studio (Gemini) 的 API 密钥，默认提供商，至少需要一个提供商密钥。

OPENAI_API_KEY 可选密钥 OpenAI 的 API 密钥，可选提供商。

OPENROUTER_API_KEY 可选密钥 OpenRouter 的 API 密钥，可选提供商；使用 openrouter 时必须同时设置 DEFAULT_MODEL。

ANTHROPIC_API_KEY 可选密钥 Anthropic 的 API 密钥，可选提供商。

其他可选配置项（7 个）

DEFAULT_LLM_PROVIDER 可选未指定 modelOverride 时使用的提供商：gemini | openai | openrouter | anthropic，默认 gemini。

DEFAULT_MODEL 可选 DEFAULT_LLM_PROVIDER 所用模型；不设置则使用各提供商默认值。

CORS_ORIGIN 可选仅 HTTP 模式：逗号分隔的浏览器来源允许列表，默认仅回环地址。

MCP_ALLOWED_HOSTS 可选仅 HTTP 模式：Host 头允许列表，用于防御 DNS 重绑定，默认 localhost/127.0.0.1/::1。

MCP_MAX_BODY_SIZE 可选仅 HTTP 模式：JSON 请求体大小上限，默认 100kb。

MCP_TRANSPORT 可选传输方式选择，未设显式标志时生效，默认 stdio。

MCP_HTTP_PORT 可选 HTTP 模式端口，默认 2091。

确保 Node.js >= 20。
运行 npx -y @pv-bhat/vibe-check-mcp start --stdio 通过 stdio 启动，或使用 --http --port 2091 启动 HTTP 模式。
获得 Gemini API 密钥（默认提供商）或可选的其他提供商密钥（OpenAI、OpenRouter、Anthropic）。
在 MCP 客户端配置中添加服务器条目，如 Claude Desktop 或 Cursor。
可选：通过环境变量设置 DEFAULT_LLM_PROVIDER 和 DEFAULT_MODEL 以选择提供商和模型。

claude_desktop_config.json

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

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

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

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

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

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在 Claude Desktop 或 Cursor 等客户端中启动服务器后，检查工具列表中是否出现 vibe_check 等工具；调用 vibe_check 并提供目标与计划，若返回导师式反馈则说明连接正常。

常见排障

如果启动失败，检查 Node.js 版本（>=20）。
确保设置至少一个 API 密钥；如果默认提供商为 Gemini 且未提供，请设置 `GEMINI_API_KEY`。
如果 HTTP 请求被拒绝，确认 `MCP_ALLOWED_HOSTS` 包含您的服务器主机名，或设置为 `*` 以禁用检查。
如果遇到速率限制或错误，检查模型兼容性并考虑指定 `modelOverride`。
使用 `npx -y @pv-bhat/vibe-check-mcp doctor`（如果可用）诊断配置问题。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

在制定计划后调用 vibe_check，挑战我的假设并检查是否过度设计
帮我把这个Bug的修复记录到 vibe_learn，以便将来反思
为本会话设置规则：不进行外部网络调用，重构前先写单元测试
查看当前会话生效的宪法规则有哪些

工具能力 5

vibe_check 只读

在规划和重大行动前挑战假设，防止隧道视野。

vibe_learn 写入

记录错误、偏好和成功，供未来反思。

update_constitution 写入

为指定 sessionId 设置或合并会话规则，CPI 层将执行这些规则。

reset_constitution 破坏性

清除指定 session 的规则。

check_constitution 只读

检查指定 session 的有效规则。

使用场景

编码任务：在编写代码前检查计划，避免过度设计。

模糊任务：帮助代理处理不明确的需求，保持对齐。

高风险任务：在不可逆操作前注入反思暂停，减少有害行为。

支持客户端

Claude Desktop

Cursor

Windsurf

VS Code

依据项目文档列出，未经本站实测。

详细介绍

Vibe Check MCP 是一个实现 Anthropic 模型上下文协议（MCP）的轻量级服务器，充当 AI 代理的“元导师”。它通过链模式中断（CPI）来打断模式惯性，防止推理锁定（RLI），使代理保持在最小可行路径上，仅在证据要求时才升级复杂性。它调用第二个 LLM 提供元认知反馈，帮助代理在关键决策前反思，提高对齐性、常识和安全性。研究支持：在评估中，它使成功率提高 ~27%，有害行为减半（-41%）。