🧠 Vibe Check MCP

Vibe Check MCP

このプロジェクトはメンテナンスモードです。 アクティブな機能開発は終了しており、メンテナンスパッチ（セキュリティ修正とバグ修正）のみが公開されます。v2.9.0 が最新のメンテナンスリリースです。サーバーは引き続き完全に動作します。MIT ライセンスのもと、コミュニティによるフォークや貢献を歓迎します。

過剰に張り切るエージェントとはお別れしましょう。すぐに使えるエージェント監督ツールです。

研究に基づいています：
私たちの研究では、Vibe Check を呼び出すエージェントの成功率が +27% 向上し、有害なアクションが -41% 減少しました

_{PulseMCP「今週の人気ツール」に掲載 • Smithery.ai で月間 5k 回以上の呼び出し • 研究に裏付けられた監督 • STDIO + ストリーム可能な HTTP トランスポート}

エージェントの過剰なエンジニアリングを防ぎ、実用最小限の道筋を維持する、すぐに使えるメンターレイヤーです。LLM の整合性、内省、安全性を保つ、研究に裏付けられた MCP サーバーです。

クイックスタート（npx）

ローカルにインストールせず、npm からサーバーを直接実行します。Node >=20 が必要です。トランスポートを選択してください：

オプション 1 – STDIO 経由の MCP クライアント

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

• MCP 対応クライアント（Claude Desktop、Cursor、Windsurf など）から起動します。
• [MCP] stdio transport connected は、プロセスがクライアントからの接続を待っていることを示します。
• コマンドを起動するよう、次のブロックをクライアントの設定に追加します。

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

オプション 2 – HTTP による手動での確認

npx -y @pv-bhat/vibe-check-mcp start --http --port 2091

• curl http://127.0.0.1:2091/healthz を実行して、サービスが稼働していることを確認します。
• http://127.0.0.1:2091/mcp に JSON-RPC リクエストを送信します。

どちらのオプションでも、npx が必要に応じてパッケージをダウンロードします。クライアントの詳細なセットアップ方法や、install、doctor などのコマンドについては、以下のドキュメントを参照してください。

評価

• PulseMCP の「Most Popular (This Week)」トップページで紹介（2025 年 10 月 13 日の週）🔗
• Anthropic 公式の Model Context Protocol リポジトリに掲載 🔗
• 公式 MCP Registry で検索可能 🔗
• Sean Kochel の「バイブコーディングをする人向けの MCP サーバー トップ 9」で紹介 🔗

目次

• クイックスタート（npx）
• Vibe Check MCP とは？
• 概要
• 問題：パターン慣性と推論のロックイン
• 主な機能
• 新機能
• 開発環境のセットアップ
• リリース
• 使用例
• 適応型メタ認知的介入（CPI）
• エージェントへのプロンプトの要点
• 各ツールの使いどころ
• ドキュメント
• 研究と理念
• セキュリティ
• ロードマップ
• コントリビューターとコミュニティ
• よくある質問
• 掲載先
• 謝辞とライセンス

---

Vibe Check MCP とは？

Vibe Check MCP は、エージェントを実行可能な最小限の経路に保ち、根拠が求める場合にのみ複雑さを段階的に高めます。Vibe Check MCP は、Anthropic の Model Context Protocol を実装した軽量サーバーです。エージェントのAI メタメンターとして機能し、**Chain-Pattern Interrupts（CPI）**によってパターン慣性を中断し、推論のロックイン（RLI）を防ぎます。LLM 用のラバーダックデバッガー、つまりエージェントが誤った方向へ進む前に行う簡単な健全性チェックのようなものと考えてください。

概要

Vibe Check MCP は、メタ認知シグナルレイヤーと CPI を組み合わせ、リスクが高まったときにエージェントが一時停止できるようにします。Vibe Check は特性、不確実性、リスクスコアを提示し、CPI はそれらのトリガーを受け取り、エージェントが処理を再開する前に介入ポリシーを適用します。接続方法の詳細については、CPI 統合ガイドおよび CPI リポジトリ（https://github.com/PV-Bhat/cpi）を参照してください。

Vibe Check は 2 つ目の LLM を呼び出し、メインエージェントにメタ認知的なフィードバックを提供します。エージェントのシステムプロンプトに vibe_check の呼び出しを組み込み、取り消せない操作の前にツールを呼び出すよう指示すると、エージェントのアラインメントと常識が大幅に向上します。コンポーネントの全体像はdocs/architecture.mdに、CPI の引き継ぎ図とシムの例はdocs/integrations/cpi.mdに記載されています。

問題：パターン慣性と推論のロックイン

大規模言語モデルは、誤った計画にも自信を持って従うことがあります。外部から促されなければ、過剰なエンジニアリングやミスアラインメントへと陥る可能性があります。Vibe Check は短い振り返りの間を通じてそのきっかけを提供し、信頼性と安全性を向上させます。

主な機能

機能	説明	メリット
CPI Adaptive Interrupts	前提に疑問を投げかける、フェーズを考慮したプロンプト	調整、堅牢性
Multi-provider LLM	Gemini 3.6、Claude 5、GPT-5.6、OpenRouter に対応	柔軟性
History Continuity	sessionId が指定されている場合、以前のアドバイスを要約	コンテキストの保持
Optional vibe_learn	今後の振り返りに役立てるため、間違いと修正を記録	自己改善

v2.9.0 の新機能（セキュリティとモデルの更新）

メンテナンスに関するお知らせ： このプロジェクトはメンテナンスモードに移行しており、機能の積極的な開発は終了しています。引き続き完全に動作し、MIT ライセンスのもとで利用できます。コミュニティによるフォークを歓迎します。詳細は変更履歴をご覧ください。

• 現行モデル： Gemini 3.6 Flash、Claude Sonnet 5／Opus 5／Fable 5、GPT-5.6 Sol／Terra／Luna が、サポート対象のデフォルトモデルになりました。これらは単一のレジストリ（src/utils/models.ts）で定義されています
• Google AI Studio にネイティブ対応： 提供終了となった @google/generative-ai パッケージから、統合された @google/genai SDK に移行しました
• HTTP の強化： CORS のデフォルトを * からループバックオリジンに変更し、DNS リバインディングを防ぐために Host ヘッダーを検証するようにしました。また、JSON ボディの上限を明示的に設定して検証します
• セキュリティ： npm audit で問題が検出されなくなりました — axios、MCP SDK の Hono スタック、form-data、fast-uri、postcss、テストツールチェーンに関する 10 件のアドバイザリを解決しました
• 依存関係： MCP SDK 1.29、axios 1.18、OpenAI SDK 6.x、vitest 4.x。未使用の body-parser 直接依存関係を削除しました

セッション憲章（セッションごとのルール）

軽量な「憲章」を使って、sessionId ごとのルールを適用できます。CPI はこのルールに従います。例：憲章のルールとして、「外部ネットワークへの呼び出しを行わない」「リファクタリングの前に単体テストを優先する」「秘密情報をディスクに書き込まない」などを設定できます。

API（ツール）：

• update_constitution({ sessionId, rules }) → セッションのルールセットを統合／設定します
• reset_constitution({ sessionId }) → セッションのルールを消去します
• check_constitution({ sessionId }) → セッションに適用されるルールを返します

開発環境のセットアップ

# Clone and install
git clone https://github.com/PV-Bhat/vibe-check-mcp-server.git
cd vibe-check-mcp-server
npm ci
npm run build
npm test

すべてのワークフローで npm を使用してください（npm ci、npm run build、npm test）。このプロジェクトの対象は Node >=20 です。

使用する API キーを記載した .env ファイルを作成します。

# Gemini (default)
GEMINI_API_KEY=your_gemini_api_key
# Optional providers / Anthropic-compatible endpoints
OPENAI_API_KEY=your_openai_api_key
OPENROUTER_API_KEY=your_openrouter_api_key
ANTHROPIC_API_KEY=your_anthropic_api_key
ANTHROPIC_AUTH_TOKEN=your_proxy_bearer_token
ANTHROPIC_BASE_URL=https://api.anthropic.com
ANTHROPIC_VERSION=2023-06-01
# Optional overrides
# DEFAULT_LLM_PROVIDER accepts gemini | openai | openrouter | anthropic
DEFAULT_LLM_PROVIDER=gemini
# Leave DEFAULT_MODEL unset to use each provider's default (see table below)
# DEFAULT_MODEL=gemini-3.6-flash

プロバイダーとモデル

Gemini は、統合された @google/genai SDK を通じて Google AI Studio（Gemini Developer API）をネイティブに利用します。プロバイダーが受け付けるモデル ID はすべて使用できます。表にはデフォルトと、vibe_check ツールのスキーマでエージェントに提示される候補を記載しています。

プロバイダー	デフォルトモデル	ほかにサポートされているモデル
gemini	gemini-3.6-flash	gemini-3.5-flash、gemini-3.5-flash-lite、gemini-2.5-pro、gemini-2.5-flash
anthropic	claude-sonnet-5	claude-opus-5、claude-fable-5、claude-haiku-4-5-20251001
openai	gpt-5.6-terra	gpt-5.6-sol、gpt-5.6-luna
openrouter	(なし — 必須)	任意の OpenRouter スラッグ（例：google/gemini-3.6-flash）

DEFAULT_LLM_PROVIDER／DEFAULT_MODEL を設定するとデフォルトを全体に適用できます。また、呼び出しごとに modelOverride を指定することもできます。DEFAULT_MODEL には DEFAULT_LLM_PROVIDER のモデルを指定します。プロバイダーを上書きしてモデルを指定しない場合は、既存のモデルを再利用せず、上書き先プロバイダーのデフォルトモデルが使用されます。

{ "goal": "...", "plan": "...", "modelOverride": { "provider": "anthropic", "model": "claude-opus-5" } }

Gemini の呼び出しに失敗した場合、サーバーは gemini-3.5-flash-lite で 1 回再試行してから、静的な質問にフォールバックします。

HTTP トランスポートの強化

これらは --http モードにのみ適用され、stdio には影響しません。

変数	デフォルト	目的
CORS_ORIGIN	ループバックオリジンのみ	ブラウザーのオリジン許可リストをカンマ区切りで指定します。* を指定すると、2.9 より前のワイルドカード設定に戻ります。
MCP_ALLOWED_HOSTS	localhost、127.0.0.1、::1	Host ヘッダーの許可リストです（DNS リバインディング対策）。* を指定するとチェックが無効になります。
MCP_MAX_BODY_SIZE	100kb	JSON ボディの上限です。解析できない値は、チェックを暗黙に無効化するのではなく、無視されます。

HTTP 経由で v2.9.0 にアップグレードする場合： Vibe Check をループバック以外のホスト名（Docker、リバースプロキシ、ホスト型デプロイなど）で提供している場合は、そのホスト名または * を MCP_ALLOWED_HOSTS に設定してください。設定しないと、リクエストは HTTP 403 で拒否されます。

設定

テストの実行方法については、docs/TESTING.md を参照してください。

Docker

リポジトリには、1 つのコマンドでセットアップできるヘルパースクリプトが含まれています。

bash scripts/docker-setup.sh

詳しくは、Docker の自動セットアップを参照してください。

プロバイダーキー

対応プロバイダー、解決順序、保存場所、セキュリティに関するガイダンスについては、API キーとシークレット管理を参照してください。

トランスポートの選択

CLI は stdio および HTTP トランスポートをサポートしています。トランスポートは、明示的なフラグ（--stdio／--http）→ MCP_TRANSPORT → デフォルトの stdio の順に決定されます。HTTP を使用する場合は、--port を指定するか、MCP_HTTP_PORT を設定してください。デフォルトのポートは 2091 です。生成される設定には、それに応じて --stdio または --http --port <n> が追加されます。また、HTTP 対応クライアントには http://127.0.0.1:<port> エンドポイントも設定されます。

クライアントのインストーラー

各インストーラーは冪等で、設定項目に "managedBy": "vibe-check-mcp-cli" のタグを付けます。変更を適用する前に、実行ごとに一度だけバックアップが作成され、マージはアトミックに行われます（*.bak ファイルを使って簡単にロールバックできます）。クライアントごとの詳しい説明については、docs/clients.mdを参照してください。

Claude Desktop

• 設定ファイルのパス：claude_desktop_config.json（プラットフォームごとに自動検出されます）。
• デフォルトのトランスポート：stdio（npx … start --stdio）。
• 新しい MCP サーバーを読み込むには、インストール後に Claude Desktop を再起動してください。
• vibe-check-mcp の管理対象外の項目がすでに存在する場合、CLI はその項目を変更せず、警告を表示します。

Cursor

• 設定ファイルのパス：~/.cursor/mcp.json（別の場所に保存している場合は --config を指定してください）。
• スキーマは Claude の mcpServers 構成に準拠しています。
• ファイルが存在しない場合、CLI はエラーにせず、Cursor の設定パネルにそのまま貼り付けられる JSON ブロックを表示します。

Windsurf (Cascade)

• 設定ファイルのパス：従来のビルドでは ~/.codeium/windsurf/mcp_config.json、新しいビルドでは ~/.codeium/mcp_config.json を使用します。
• Windsurf の HTTP クライアント向けに serverUrl を含む項目を出力するには、--http を指定してください。
• 既存のセンチネル管理対象の serverUrl 項目は保持され、その場で更新されます。

Visual Studio Code

• ワークスペースの設定は .vscode/mcp.json に保存されます。プロファイルでは VS Code のユーザーデータディレクトリにも mcp.json が保存されます。
• ワークスペースのファイルを指定するには --config <path> を指定してください。--config を指定しない場合、CLI は JSON スニペットと、ターミナルから直接開ける vscode:mcp/install?... リンクを表示します。
• VS Code は任意の開発用フィールドをサポートしています。dev.watch／dev.debug を設定するには、--dev-watch および／または --dev-debug <value> を指定してください。

アンインストールとロールバック

• インストール時に生成されたバックアップ（設定ファイルの隣にある最新の *.bak）を復元すると、すぐに元の状態に戻せます。
• サーバーを手動で削除するには、"managedBy": "vibe-check-mcp-cli" のタグが付いたままであれば、mcpServers（Claude／Windsurf／Cursor）または servers（VS Code）配下の vibe-check-mcp 項目を削除してください。

研究と理念

**CPI（Chain-Pattern Interrupt）は、Vibe Check の基盤となる、研究に裏付けられた監督手法です。リスクが高まるタイミングで、適切な間隔を置いて短い「一時停止ポイント」を挿入し、エージェントをユーザーの真の優先事項に再び合わせることで、破壊的な連鎖と推論の固定化（RLI）を防ぎます。153 回の実行を対象とした統合評価では、CPI により成功率がほぼ倍増（約 27%→54%）し、有害なアクションがおよそ半減（約 83%→42%）しました。最適な割り込みの頻度はステップの約 10～20%**です。Vibe Check MCP は、テスト時に外部メンター層として CPI を実装します。

リンク：

• 📄 CPI 論文（ResearchGate） — http://dx.doi.org/10.13140/RG.2.2.18237.93922
• 📘 CPI リファレンス実装（GitHub）: https://github.com/PV-Bhat/cpi
• 📚 MURST Zenodo DOI（RSRC アーカイブ）: https://doi.org/10.5281/zenodo.14851363

flowchart TD
  A[Agent Phase] --> B{Monitor Progress}
  B -- high risk --> C[CPI Interrupt]
  C --> D[Reflect & Adjust]
  B -- smooth --> E[Continue]

エージェントのプロンプト作成の要点

エージェントのシステムプロンプトで、振り返りには vibe_check が必須のツールであることを明確にしてください。ユーザーの依頼全文と、その他の関連するコンテキストを必ず渡してください。間違いを修正した後、必要に応じて vibe_learn に記録し、今後の分析に活用できる履歴を作成できます。

スニペットの例：

As an autonomous agent you will:
1. Call vibe_check after planning and before major actions.
2. Provide the full user request and your current plan.
3. Optionally, record resolved issues with vibe_learn.

各ツールの用途

ツール	目的
🛑 vibe_check	前提に疑問を投げかけ、視野が狭くなるのを防ぐ
🔄 vibe_learn	間違い、好み、成功を記録する
🧰 update_constitution	CPI 層が適用するセッションルールを設定／統合する
🧹 reset_constitution	セッションのルールを消去する
🔎 check_constitution	セッションに適用されているルールを確認する

ドキュメント

• エージェントのプロンプト作成戦略
• CPI の統合
• 高度な統合
• 技術リファレンス
• Docker の自動セットアップ
• 理念
• ケーススタディ
• 変更履歴

セキュリティ

このリポジトリには、すべてのプルリクエストで実行される CI ベースのセキュリティスキャンが含まれています。npm audit で依存関係をチェックし、ソースコードにリスクのあるパターンがないかスキャンします。詳細と問題の報告方法については、SECURITY.md をご覧ください。

ロードマップ

**注記：**このプロジェクトはメンテナンスモードです（最新のメンテナンスリリース：v2.9.0）。以下のロードマップは、開発の継続を希望するコミュニティフォーク向けに保存されています。

• vibe_check の構造化出力： { advice, riskScore, traits } のような JSON エンベロープを返し、後続のエージェントが決定論的に推論できるようにします。
• LLM の耐障害性： generateResponse をリトライと指数バックオフでラップします。
• 入力のサニタイズ： プロンプトインジェクションの攻撃経路を軽減するため、ツール引数を検証して無害化します。
• プロンプトの外部化： ハードコードされたプロンプトを設定ファイルに移し、透明性と監査可能性を高めます（PR #71 を参照）。

コントリビューターとコミュニティ

コントリビューションを歓迎します！CONTRIBUTING.md をご覧ください。

リンク

• MSEEP
• MCP Servers
• MCP.so
• Creati.ai
• Pulse MCP
• Playbooks.com
• MCPHub.tools
• MCP Directory

クレジットとライセンス

Vibe Check MCP は MIT License の下で公開されています。信頼性が高く、エンタープライズ対応の AI エージェント向けに構築されています。

作者のクレジットとリンク

Vibe Check MCP の作成者：Pruthvi Bhat、イニシアチブ - https://murst.org/