PV Bhat Vibe Check MCP Server

🚀 Vibe Check项目

Vibe Check是一款专门解决大型语言模型（LLM）代理在运行时，因“思维惯性”导致无序行为问题的工具。它整合了vibe_check、vibe_distill和vibe_learn三个核心功能，能让LLM代理在运行时主动识别并纠正推理过程中的偏差。

🚀 快速开始

Vibe Check可有效解决大型语言模型（LLM）代理运行时的无序行为问题。你可通过Smithery自动安装，也能手动安装。安装完成后，按指引进行配置和集成，即可使用其核心功能。

✨ 主要特性

1. vibe_check

• 用途：当代理为开发待办事项应用程序，开始解释区块链基础概念（如区块、链表等）时，强制执行阶段一致的中断。
• 触发条件：代理处理与当前任务无关的概念或逻辑时。
• 实现机制：在每个推理阶段（规划/实施/审查）中嵌入检查点，确保中断的有效性。

2. vibe_distill

• 用途：当代理的计划包含过多嵌套要点（如详细到技术规范文档程度）时，强制执行压缩和简化。
• 触发条件：代理生成过于复杂的解决方案或计划时。
• 实现机制：将复杂逻辑转换为简明扼要的关键点链，作为重新校准的基础。

3. vibe_learn

• 用途：在代理陷入过度复杂性之后，记录和分析错误模式，以优化后续中断策略。
• 触发条件：用户手动将代理从复杂性中引导回来后。
• 实现机制：建立反馈循环，用于存储和利用历史错误数据。

📦 安装指南

通过 Smithery 自动安装

要通过 Smithery 自动为 Claude Desktop 安装 vibe-check-mcp-server，可执行以下命令：

npx -y @smithery/cli install @PV-Bhat/vibe-check-mcp-server --client claude

手动安装（推荐）

# 克隆仓库
git clone https://github.com/PV-Bhat/vibe-check-mcp-server.git
cd vibe-check-mcp-server

# 安装依赖项
npm install

# 构建项目
npm run build

# 启动服务器
npm run start

📚 详细文档

与 Claude 的集成

在你的 claude_desktop_config.json 文件中添加以下内容：

"vibe-check": {
  "command": "node",
  "args": [
    "/path/to/vibe-check-mcp/build/index.js"
  ],
  "env": {
    "GEMINI_API_KEY": "YOUR_GEMINI_API_KEY"
  }
}

环境配置

在项目根目录中创建一个 .env 文件：

GEMINI_API_KEY=your_gemini_api_key_here

代理提示指南

为有效实现模式中断，请在系统提示中包含以下指令：

作为一个自主代理，你需要：
1. 将 vibe_check 视为关键的模式中断机制
2. 在每次调用时始终包含完整的用户请求
3. 指定具体的推理阶段（规划/实施/审查）
4. 使用与上下文相关的中断策略

项目结构

.
├── README.md          # 项目文档
├── package.json      # 项目依赖和脚本
├── src/
│   ├── index.js     # 主程序入口
│   └── utils/
│       ├── check.js  # vibe_check 实现
│       ├── distill.js # vibe_distill 实现
│       └── learn.js   # vibe_learn 实现
└── .env.example      # 环境变量示例

💻 使用示例

基础用法

示例 1: 开发待办事项应用

{
  "name": "todo-app",
  "description": "A simple todo application built with Node.js.",
  "planning": {
    "features": ["CRUD operations", "User authentication"],
    "technologies": ["Node.js", "Express.js", "MongoDB"]
  }
}

示例 2: 区块链基础教学

{
  "name": "blockchain-lesson",
  "description": "Teaching blockchain basics to new developers.",
  "planning": {
    "topics": ["Block structure", "Blockchain validation"],
    "examples": ["Bitcoin transaction flow", "Ethereum smart contracts"]
  }
}

🔧 技术细节

API 参考

1. vibe_check

• 用途：在规划、实施或审查阶段中嵌入中断检查点。
• 输入参数：
  • stage：当前推理阶段（"planning" | "implementing" | "reviewing"）
  • context：上下文信息（如当前任务描述、已执行步骤等）
• 返回值：中断策略或继续信号

2. vibe_distill

• 用途：将复杂推理过程简化为关键点链。
• 输入参数：
  • complexity_level：复杂度指标（1 - 5）
  • content：需要简化的上下文信息
• 返回值：简化后的关键点列表

3. vibe_learn

• 用途：分析和记录推理过程中的错误模式。
• 输入参数：
  • error_type：错误类型（"偏离主题" | "过度复杂" | "逻辑错误"）
  • context：错误发生时的上下文信息
• 返回值：反馈信号或优化建议

📄 许可证

本项目采用 MIT License。

⚠️ 重要提示

1. 环境依赖：确保已安装 Node.js 和 npm。
2. 权限设置：确保有正确的文件读写权限。
3. 错误处理：在生产环境中建议添加错误捕捉和日志记录机制。

💡 使用建议

欢迎任何贡献！请参考 CONTRIBUTING.md 文件了解如何参与。如有任何问题，请联系 作者邮箱 或访问 项目主页。