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 文件瞭解如何參與。如有任何問題，請聯繫 作者郵箱 或訪問 項目主頁。