/ ディレクトリ / プレイグラウンド / vibe-check-mcp-server
● コミュニティ PV-Bhat ⚡ 即起動

vibe-check-mcp-server

作者 PV-Bhat · PV-Bhat/vibe-check-mcp-server

エージェントの実行計画に対して異議を唱える第2の LLM―トンネル視野、過剰設計、推論のロックインを捕捉します。

vibe-check-mcp (PV-Bhat) は Chain-Pattern Interrupts (CPI) 経由でエージェントにメタ認知的フィードバックを提供します。主要な意思決定ポイントで前提条件に異議を唱えるために第2のモデルを呼び出します。プロジェクトはメンテナンスモード (v2.8.0 最終版) ですが、MIT ライセンスの下で完全に機能します。

なぜ使うのか

主な機能

ライブデモ

実際の動作

vibe-check.replay ▶ 準備完了
0/0

インストール

クライアントを選択

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "vibe-check": {
      "command": "npx",
      "args": [
        "-y",
        "vibe-check-mcp-server"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config を開く。保存後、アプリを再起動。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "vibe-check": {
      "command": "npx",
      "args": [
        "-y",
        "vibe-check-mcp-server"
      ],
      "_inferred": true
    }
  }
}

Cursor は Claude Desktop と同じ mcpServers スキーマを使用。プロジェクト設定はグローバルより優先。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "vibe-check": {
      "command": "npx",
      "args": [
        "-y",
        "vibe-check-mcp-server"
      ],
      "_inferred": true
    }
  }
}

Cline サイドバーの MCP Servers アイコンをクリックし、"Edit Configuration" を選択。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "vibe-check": {
      "command": "npx",
      "args": [
        "-y",
        "vibe-check-mcp-server"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop と同じ形式。Windsurf を再起動して反映。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "vibe-check",
      "command": "npx",
      "args": [
        "-y",
        "vibe-check-mcp-server"
      ]
    }
  ]
}

Continue はマップではなくサーバーオブジェクトの配列を使用。

~/.config/zed/settings.json
{
  "context_servers": {
    "vibe-check": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "vibe-check-mcp-server"
        ]
      }
    }
  }
}

context_servers に追加。保存時に Zed がホットリロード。

claude mcp add vibe-check -- npx -y vibe-check-mcp-server

ワンライナー。claude mcp list で確認、claude mcp remove で削除。

ユースケース

実用的な使い方: vibe-check-mcp-server

vibe-check で破壊的なアクション前にプランをサニティチェックする

👤 書き込みアクセスを持つエージェントを実行する人は誰でも ⏱ ~10 min beginner

使うタイミング: エージェントがファイルを削除、マイグレーション実行、またはデプロイしようとしている―第二の意見を望みます。

フロー
  1. プランに vibe_check を呼び出します
    マイグレーションを実行する前に、このプランで vibe_check を呼び出してください:[貼り付け]。何が悪くなる可能性がありますか?✓ コピーしました
    → 異議リスト:チェックされていない前提条件、ロールバック漏れ、スコープクリープ
  2. 各懸念事項を明示的に解決または無視する
    各懸念事項に対処してください―軽減するか、明示的に範囲外として却下してください。✓ コピーしました
    → 注釈が付いたプランは実行の準備ができています

結果: 破壊的なアクション後の『ああもう』という瞬間が減ります。

注意点
  • エージェントがすべての懸念をゴム印スタイルで却下する — エージェントが各懸念事項と具体的な軽減策を言い換えることを要求してください。
組み合わせ: sequentialthinking-tools

vibe-check の constitution でセッションルールを実装する

👤 エージェントワークフローを共有するチーム ⏱ ~10 min intermediate

使うタイミング: 特定のルール (メインにプッシュしない、常に最初にテストを書く) をセッション全体で実装したい場合。

フロー
  1. constitution を設定する
    update_constitution を使用してこのセッションの次のルールを設定します:[リスト]。それらに違反する可能性のあるすべてのツール呼び出しで CPI 経由で実装します。✓ コピーしました
    → ルールが確認されました;その後の違反は割り込まれます
  2. 疑わしい場合は検査する
    check_constitution を呼び出して、現在有効なものを確認します。✓ コピーしました
    → 現在のルールリスト

結果: 毎回ルールを繰り返さずにセッション内で一貫したエージェント動作。

vibe_learn でエージェントの間違いからレッスンをキャプチャする

👤 プロンプトを反復しているエージェント開発者 ⏱ ~5 min beginner

使うタイミング: エージェントが古典的な間違いを犯しました;繰り返さないようにしたい場合。

フロー
  1. レッスンを記録する
    vibe_learn を次のように呼び出します:mistake='deleted prod table without snapshot', lesson='always take a snapshot before DDL on prod'。✓ コピーしました
    → レッスンがセッション用に保存されました
  2. (同じセッションの後で) DDL を試みる―vibe_check は保存されたレッスンを表示します
    (同じセッションの後で) DDL を試みる―vibe_check は保存されたレッスンを表示します✓ コピーしました
    → 関連する過去のレッスンで割り込みます

結果: プロンプトエンジニアリングなしで『二度とそれをしないで』というセッション内メモリ。

組み合わせ

他のMCPと組み合わせて10倍の力を

プラン + 異議ループ

sequentialthinking_tools でプランを作成し、ステップ 1 を実行する前にプランで vibe_check を呼び出します。✓ コピーしました
vibe-check + overture

ビジュアルプラン + vibe-check レイヤー

Overture がプラングラフを生成した後、それで vibe_check を実行し、懸念事項を注釈として表示します。✓ コピーしました

ツール

このMCPが提供する機能

ツール入力呼び出すタイミングコスト
vibe_check plan: str, context?: str 些細でない、または不可逆的なアクション前 あなたが設定したプロバイダー経由で 1 LLM 呼び出し
vibe_learn mistake: str, lesson: str 間違い直後、新鮮な間に 0
update_constitution rules: str[] セッション開始またはポリシー変更時 0
check_constitution 予期しない割り込みをデバッグする 0
reset_constitution リセット開始 0

コストと制限

運用コスト

APIクォータ
選択した LLM の割り当てを使用します
呼び出しあたりのトークン
vibe_check の場合 500-3000
金額
LLM トークンコストのみ
ヒント
実質的なプランでのみ vibe_check を実行してください―些細な編集をスキップするとトークンを節約できます

セキュリティ

権限、シークレット、影響範囲

認証情報の保管: env の LLM API キー (OPENAI_API_KEY, ANTHROPIC_API_KEY など)
データ送信先: 設定した LLM プロバイダーのみへ

トラブルシューティング

よくあるエラーと対処法

vibe_check が空の懸念を返す

プラン入力が漠然としすぎています―具体的なステップと副作用を含めてください

エージェントが vibe_check 出力を無視する

システムプロンプトが進む前に各懸念事項に対処することを要求するようにしてください

npx が @pv-bhat/vibe-check-mcp を見つけられない

公開されたスコープは @pv-bhat です;最新バージョンを明示的にピン留めします:npx -y @pv-bhat/vibe-check-mcp@latest

代替案

vibe-check-mcp-server 他との比較

代替案代わりに使う場面トレードオフ
sequentialthinking-toolsプランニングが必要で、異議は不要な場合異なる形状―敵対的な第2モデルなし
overtureテキスト異議の代わりにビジュアルゲーティングが必要な場合より重い設定

その他

リソース

📖 GitHub の公式 README を読む

🐙 オープンな issue を見る

🔍 400以上のMCPサーバーとSkillsを見る