PV Bhat Vibe Check MCP Server

🚀 Vibe Check

Vibe Check は、大規模言語モデル（LLM）エージェントが実行中に「思考の慣性」によって引き起こされる無秩序な行動の問題を解決するためのツールです。vibe_check、vibe_distill、vibe_learn の3つの核心機能を統合することで、LLM エージェントが実行時に推論過程の逸脱行動を自動的に識別し、修正する仕組みを提供します。

🚀 クイックスタート

Vibe Check を使って、LLM エージェントの無秩序な行動を解消しましょう。以下のセクションでは、インストール方法、使用例、API リファレンスなどを紹介します。

✨ 主な機能

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

💻 使用例

基本的な使用法

例 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"]
  }
}

📚 ドキュメント

インストールガイド

1. Smithery を通じた自動インストール
2. 手動インストール（推奨）

統合ガイド

1. Claude との統合
2. 環境設定

API リファレンス

1. vibe_check
2. vibe_distill
3. vibe_learn

🔧 技術詳細

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

API リファレンス

1. vibe_check

• 用途：計画、実装、またはレビュー段階に中断チェックポイントを埋め込みます。
• 入力パラメータ：
  • stage：現在の推論段階（"planning" | "implementing" | "reviewing"）
  • context：コンテキスト情報（現在のタスク説明、実行済みの手順など）
• 戻り値：中断戦略または継続信号

2. vibe_distill

• 用途：複雑な推論過程を要点のチェーンに簡素化します。
• 入力パラメータ：
  • complexity_level：複雑度指標（1 - 5）
  • content：簡素化する必要があるコンテキスト情報
• 戻り値：簡素化された要点のリスト

3. vibe_learn

• 用途：推論過程のエラーパターンを分析して記録します。
• 入力パラメータ：
  • error_type：エラーの種類（"off-topic" | "overly-complex" | "logical-error"）
  • context：エラーが発生したときのコンテキスト情報
• 戻り値：フィードバック信号または最適化提案

📄 ライセンス

このプロジェクトは MIT License の下でライセンスされています。

注意事項

⚠️ 重要提示

1. 環境依存：Node.js と npm がインストールされていることを確認してください。
2. 権限設定：正しいファイルの読み書き権限があることを確認してください。
3. エラー処理：本番環境では、エラー捕捉とログ記録メカニズムを追加することをお勧めします。

貢献ガイド

どんな貢献も歓迎します！詳細は CONTRIBUTING.md を参照してください。

連絡先

何か質問があれば、作者のメールアドレス に連絡するか、プロジェクトのホームページ を訪問してください。