🧭 Vibe Check MCP

🧭 Vibe Check MCP

シニアエンジニアとの協調的な推論によって、AI コーディングを安全に進めましょう。90％まで完成させたのに、そこから何週間も行き詰まるのはつらいものです。

Vibe Check MCP v0.5.1 は、AI が生成したコードで身動きが取れなくなるのを防ぎます。まるで、シニアエンジニアのチームがそばで見守り、リアルタイムで誤った判断を止め、修復不能な問題に何日も費やす前に、大きな損失につながるミスを見つけてくれるようなものです。

🧠 シニアエンジニアとの協調的な推論

実際に、問題が起きる前に大惨事を防ぐ画期的な機能です。

🚨 割り込みモード — 誤った判断をその場で止める

❌ You: "I'll build a custom HTTP client for this API"
✅ Mentor: "Have you checked if an official SDK exists?" (INTERRUPT!)

大きな損失につながるミスを犯しそうになったとき、実際にあなたを止めてくれます。 シニアエンジニアが肩をたたいて、「ちょっと待って……」と言ってくれるようなものです。

🤝 複数のペルソナによる協調的な推論

複数のエンジニアリングの視点から同時にフィードバックを得られます。

• 👨‍💻 シニアエンジニア：「時期尚早な最適化に見えます」
• 📋 プロダクトマネージャー：「これは本当にユーザーの課題を解決していますか？」
• 🤖 AI/ML エンジニア：「既存のモデルを使えば、もっとシンプルに実現できます」

🎯 実際に防げる大惨事：

• Auth0 があるのに、独自の認証システムを構築する
• GraphQL エンドポイントがあるのに、REST API を作成する
• ライブラリで処理できるのに、複雑なパーサーを実装する
• Cognee の事例：公式の Docker コンテナが存在することを突き止め、2週間以上に及ぶ独自開発を防止

Claude Code MCP 統合向けに構築 — 既存の Claude Code ワークフローにシームレスに統合され、リアルタイムのエンジニアリングコーチングを提供します。

🎯 対象ユーザー

何週間もかけて何かを作ったのに、実は簡単な API 呼び出しで済んだと気づいたことはありませんか？

あなただけではありません。Vibe Check は、AI コーディングツールが好きでも、AI が生み出しがちな過剰設計の落とし穴を避けるためにチェックを必要とするバイブコーダー向けに特別に設計されています。

こんな経験はありませんか？

🔥 「Claude を使って単語ゲームを作るのに417ドルも費やしたのに、AI が生成したコードにサーバー側の検証がなく、Bee Movie の台本全文を使った DDoS 攻撃を受けてしまった」
🔥 「LLM が iOS アプリのデータベース全体を Core Data ではなく CSV ファイルに書いてしまった。まったく気づかなかった！」
🔥 「ChatGPT にエラーを貼り付けてコードを再生成させ続けたら、いつまでも2つのエラー状態の間を行き来するようになった」 🔥 「自分が書いているコードが実際に何をしているのか、すでに把握できなくなっている人がいます。AI を使えばコードをより早く仕上げられますが、壊れたときのデバッグや修正はずっと難しくなることがあります」

次のような方が対象です：

• 🎮 AI コーディングツールが好き — Claude、Cursor、Copilot を使っているものの、提案が過剰設計ではないか気になることがある
• 🤔 信頼しつつも検証したい — AI の解決策に期待する一方、妥当性を確認できるほどライブラリに詳しくない
• 🔄 終わりのないループに陥っている — AI の修正によって新たな問題が発生するサイクルを経験している
• 📚 プロのようにコードをレビューできない — AI の提案を深く技術的にレビューせずに受け入れてしまう（それはごく普通のことです！）
• ⚡ 完璧さよりスピードを重視する — アーキテクチャ上の完璧さより、動く解決策を優先する

実際に直面する課題：

• セキュリティ上の盲点：AI は重要な検証処理を欠いたコードを自信満々に生成します（ハッキングされた 417 ドルのゲームのように）。
• 終わりのないループ：コードの変更がエラー状態の間を延々と行き来し、何時間も浪費します。
• 時代遅れの解決策：AI は現在のベストプラクティスではなく、非推奨の手法を提案します。
• 理解の喪失：AI が書いたコードは、いずれ問題が起きても自分ではデバッグできません。
• 混在した言語構文：AI が Rust のコードに Go のライブラリをインポートするなど、支離滅裂な組み合わせを生成します。
• 自信満々の誤回答：AI は完全に誤った情報についても、権威ある口調で話します。

Vibe Check MCP は、AI コーディングのセーフティネットです。高額な落とし穴を避けながら、バイブコーディングの楽しさを保ちます。

🎯 できること

Vibe Check MCP は、エンジニアリング上のアンチパターンが高額な失敗につながる前に検出するため、3 つの分析モードを提供します。

🧠 シニアエンジニアのメンター（MCP Sampling 統合で強化！）

• ネイティブ MCP プロトコルによる動的な応答生成。API キーは不要です。
• 複数のエンジニアリング担当者の視点を用いた協調的な推論
• 静的（高速）応答と動的（柔軟）応答のハイブリッドな振り分け
• 不適切な判断をリアルタイムで止める割り込みモード
• 複雑な技術的判断のためのアーキテクチャに関するガイダンス
• 分析のニーズに応じたClaude モデルの選択（Haiku／Sonnet／Opus）
• サブミリ秒のコアコンポーネントによる、エンタープライズ対応の効率性

🚀 高速分析（即時フィードバック）

• 外部 API 呼び出しを伴わない迅速なパターン検出
• 計画段階のアンチパターンを検出するGitHub イシュー分析
• 開発ワークフロー向けのPR メトリクスと基本レビュー
• 技術文書や計画向けのテキスト分析

🧠 詳細分析（包括的なレビュー）

• 複雑なアンチパターンを検出するClaude による推論
• パターンに問題がある理由を説明する学習に役立つ解説
• 実例を用いたケーススタディ（Cognee 統合から得た学びなど）
• 具体的な修正手順を含む、実行可能な予防ガイダンス

検出される主なアンチパターン

検証済みの結果：包括的なテストで、検出精度 87.5％、誤検知 0％、コンポーネントのレイテンシはサブミリ秒を達成しています。

⚡ 新機能：ネイティブ MCP Sampling 統合（v0.5.1）

Vibe Check をすべての競合製品と差別化する、革新的な動的応答生成：

🚀 主な競争上の優位性

• 🔐 API キー不要：ネイティブ MCP プロトコルを統合しているため、完全にオフラインで動作します。
• ⚡ パフォーマンスの最適化：サブミリ秒のコアコンポーネントにより、エンタープライズ対応の効率性を実現します。
• 🧠 ハイブリッドインテリジェンス：静的応答（<100ms）と動的生成（~2000ms）をスマートに振り分けます。
• 🛡️ セキュリティを内蔵：秘密情報の自動マスキング、インジェクションの防止、レート制限を備えています。
• 🔄 サーキットブレーカーパターン：あらゆる状況で信頼性を確保できるよう、適切に機能を縮退させます。

🎯 仕組み

# High confidence queries → Static response (50ms)
"Use official Stripe SDK instead of custom HTTP client"

# Low confidence queries → Dynamic MCP sampling (2000ms)  
"Analyze this complex microservice architecture for anti-patterns"

# Hybrid approach for balanced speed/flexibility (500ms)
"Review this FastAPI + Supabase integration approach"

📊 パフォーマンス指標

• キャッシュヒットの最適化：一般的なクエリのレイテンシを 85％削減
• P95 レイテンシ：動的生成で約 2000ms（目標の 3 秒を十分に下回ります）
• 静的応答：即時フィードバックで <100ms
• フォールバック保護：30 秒のタイムアウトと自動復旧

このネイティブ MCP 統合により、エンタープライズグレードのパフォーマンスとセキュリティを提供しながら、外部 API の管理が不要になります。

🎯 新機能：プロジェクトを認識したコンテキスト分析

一般的なアドバイスとはさようなら！Vibe Check は、使用している技術スタックを理解し、ライブラリに特化した推奨事項を提示します。

❌ Before（一般的）

User: "Should I build a custom authentication system?"
Vibe Check: "Generally, avoid custom auth. Use established libraries."

✅ After（プロジェクトを認識）

User: "Should I build a custom authentication system?"
Vibe Check: "I see you're using FastAPI + Supabase. Supabase has built-in auth with 
JWT tokens and Row Level Security. Use the @supabase/auth-js client for 
frontend auth state management. This eliminates the need for custom auth entirely."

🏗️ 3 層のコンテキストシステム

1. 🔍 ライブラリ検出エンジン

   • プロジェクトのファイルと依存関係を自動的にスキャンします
   • FastAPI、React、Supabase、GitHub 連携、OpenAI の使用を検出します
   • 信頼度スコア：FastAPI 95％、Supabase 87％、React 92％

2. 📖 プロジェクトドキュメントパーサー

   • README.md、CONTRIBUTING.md、docs/ を読み取ります
   • チームの規約とアーキテクチャ上の決定を抽出します
   • 固有のパターンや例外を理解します

3. 🧠 コンテキストを考慮した分析

   • シニアエンジニア：「FastAPI + Supabase では、組み込みの RLS 認証を使用してください」
   • プロダクトエンジニア：「Supabase 認証は @supabase/auth-js を介して React と連携します」
   • AI エンジニア：「Supabase のユーザー埋め込みを ML 機能に活用してください」

🛠️ 新しい MCP ツール

• detect_project_libraries - コードベースをスキャンして技術スタックを検出します
• load_project_context - プロジェクトの包括的な分析を取得します
• create_vibe_check_directory_structure - .vibe-check/ の設定をセットアップします

📖 コンテキストドキュメントの完全ガイド →

🛡️ エンタープライズ向けセキュリティ機能

パフォーマンスを損なわずに、本番環境に対応したセキュリティを実現します。

🔒 自動セキュリティ保護

• シークレットの検出とマスキング：API キー、パスワード、トークンを自動的に識別してマスキングします
• プロンプトインジェクションの防止：パターンマッチングにより、悪意のあるプロンプト操作を防止します
• パスの検証：シンボリックリンク攻撃や不正なファイルアクセスを防止します
• レート制限：セッションあたり毎分 10 リクエストに制限し、不正利用を防止します
• タイムアウト保護：30 秒の制限と、適切なフォールバックを提供します

📊 セキュリティパフォーマンス

• 最適化されたパフォーマンス：静的パスは約 0.1ms、動的パスは約 2000ms
• 12 件の脆弱性を緩和：組み込みのセキュリティレイヤーによる包括的な保護
• サーキットブレーカーによる復旧：セキュリティイベントから 60 秒後に自動復旧します
• 外部依存関係なし：すべてのセキュリティ処理を MCP プロトコル内でローカルに実行します

🏢 エンタープライズ向けのメリット

• コンプライアンス対応：データが環境外に送信されません
• 監査証跡：セキュリティレビュー用の包括的なログを記録します
• オフライン動作：インターネット接続なしで動作します
• 設定不要：セキュリティはデフォルトで有効です

セキュリティ態勢を損なわずに AI アシスタンスを必要とするチームに最適です。

⚡ クイックスタート

前提条件

• Claude Code がインストールされ、設定されていること
• pip を備えた Python 3.8 以降
• GitHub トークン（任意、GitHub 連携用）

🚀 インストール方法

お使いの環境に最適なインストール方法を選択してください。

🎯 オプション 1：NPX（すぐにセットアップ）- おすすめ！

# Run directly without installation
npx vibe-check-mcp --stdio

# Add to Claude Code MCP config with GitHub token (for private repos)
claude mcp add vibe-check-npm -e GITHUB_TOKEN="your_github_token_here" -- npx vibe-check-mcp --stdio

# Or without GitHub token (public repos only)
claude mcp add vibe-check-npm -- npx vibe-check-mcp --stdio

メリット：

• ✅ ローカルへのインストールが不要です
• ✅ 常に最新バージョン（v0.5.1 以降）を実行します
• ✅ Python の依存関係（aiohttp、PyYAML など）を自動的に管理します
• ✅ クロスプラットフォームに対応しています
• ✅ 信頼性の高い MCP サーバー接続（v0.5.1 で MCP サンプリングにより強化）
• ✅ プライベートリポジトリの分析には GitHub トークンを任意で指定できます

🎯 オプション 2：Smithery（本番環境におすすめ）

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

メリット：

• ✅ すべての依存関係とともに Vibe Check MCP をインストールします
• ✅ Claude Code の MCP 連携を自動的に設定します
• ✅ 環境変数を適切に設定します
• ✅ インストールとサーバーの健全性を検証します
• ✅ Smithery を介した自動更新を有効にします
• ✅ 本番環境に対応した設定を提供します

🎯 オプション 3：ローカル開発環境のセットアップ

プロジェクトへの貢献やサーバーのカスタマイズに最適です。

# 1. Clone and install dependencies
git clone https://github.com/kesslerio/vibe-check-mcp.git
cd vibe-check-mcp
pip install -r requirements.txt

# 2. Test server locally
PYTHONPATH=src python -m vibe_check.server --help

# 3. Add local development server to Claude Code (with GitHub token)
claude mcp add vibe-check-local -e PYTHONPATH="$(pwd)/src" -e GITHUB_TOKEN="your_github_token_here" -- python -m vibe_check.server --stdio

# Or without GitHub token (public repos only)
claude mcp add vibe-check-local -e PYTHONPATH="$(pwd)/src" -- python -m vibe_check.server --stdio

# 4. Restart Claude Code

ローカル開発環境を使用する場合：

• ✅ プロジェクトに貢献する
• ✅ アンチパターン検出ルールをカスタマイズする
• ✅ 新しいツールや機能を追加する
• ✅ 未リリースの変更をテストする

🎯 オプション 4：手動インストール（上級者向け）

# 1. Clone and install
git clone https://github.com/kesslerio/vibe-check-mcp.git
cd vibe-check-mcp
pip install -r requirements.txt

# 2. Add to Claude Code with GitHub token
claude mcp add vibe-check -e PYTHONPATH="$(pwd)/src" -e GITHUB_TOKEN="your_github_token_here" -- python -m vibe_check.server --stdio

# Or without GitHub token (public repos only)
claude mcp add vibe-check -e PYTHONPATH="$(pwd)/src" -- python -m vibe_check.server --stdio

# 3. Restart Claude Code and start using!

💡 **Tip**: Add `-s project` to share with your team via .mcp.json, or `-s user` to use across all your projects.

🎯 オプション 5：スクリプトによるインストール

curl -fsSL https://raw.githubusercontent.com/kesslerio/vibe-check-mcp/main/install.sh | bash

🔧 設定

🔐 GitHub トークンの設定

必要となる用途： プライベートリポジトリ、組織のリポジトリ、レート制限の緩和

必要となるケース：

• ✅ GitHub のプライベートリポジトリを分析する場合
• ✅ 組織のリポジトリを分析する場合
• ✅ API のレート制限を緩和する場合（1 時間あたり 5000 回と 60 回の違い）
• ❌ 公開リポジトリの分析では不要です

GitHub トークンの取得方法：

1. GitHub → Settings → Developer settings → Personal access tokens → Tokens (classic) に移動します
2. 「Generate new token (classic)」をクリックします
3. 次の権限を選択します：
   • ✅ repo（プライベートリポジトリへのアクセス用）
   • ✅ read:org（組織のリポジトリ用）
4. トークンをコピーします（ghp_ で始まります）

トークンの使用方法：

# Option A: Set as environment variable (recommended)
export GITHUB_TOKEN="ghp_your_token_here"
# Add to ~/.zshrc or ~/.bashrc for persistence

# Option B: Pass directly in MCP config (see installation options above)

セキュリティに関する注意： トークンは安全に保管してください。バージョン管理にコミットしないでください。

⚙️ ツールアーキテクチャの設定（Issue #237）

用途に応じて公開するツールを制御します。

本番モード（デフォルト） - 30 個のツール：

# No environment variables needed - this is the default
# Includes all core anti-pattern detection and analysis tools

診断モード - 診断ツールを 11 個追加：

export VIBE_CHECK_DIAGNOSTICS=true

# Enables:
# - Claude CLI diagnostics (2 tools: status, diagnostics)
# - Configuration validation (2 tools: validate_mcp, check_integration)
# - Async LLM monitoring (7 tools: async analysis, health, metrics, status)

開発モード - 開発用／実験用ツールを 2 個追加：

export VIBE_CHECK_DEV_MODE=true

# Enables:
# - demo_large_prompt_handling (experimental features)
# - reset_session_tracking (dev utility)

包括的なテストモード：

export VIBE_CHECK_DEV_MODE_OVERRIDE=true

# Enables all dev tools + comprehensive test suite
# For contributors and advanced debugging

環境ベースの制御によるメリット：

• ✅ デフォルトのツール数を 30% 削減（43 個 → 30 個）
• ✅ リクエストごとに 約 650 トークンを節約
• ✅ エンドユーザーがツールを見つけやすくなる
• ✅ プロフェッショナルな外観（内部テスト用ツールを公開しません）
• ✅ トラブルシューティングが必要なときに、オプトインで診断機能を利用可能
• ✅ 下位互換性を維持し、すべてのツールを引き続き利用可能

🚀 Claude Code のクイックセットアップ

このプロジェクトは Claude Code との連携に特化して設計されているため、最速のセットアップ方法を紹介します。

ステップ 1：Claude Code に追加する（推奨）

# With GitHub token (for private repositories)
claude mcp add vibe-check -e GITHUB_TOKEN="your_github_token_here" -- npx vibe-check-mcp --stdio

# Or without GitHub token (public repositories only)
claude mcp add vibe-check -- npx vibe-check-mcp --stdio

ステップ 2：Claude Code を再起動する

# Restart Claude Code to load the new MCP server
# No installation, dependencies, or local setup required!

ステップ 3：動作を確認する

# Test that the MCP server is working
claude "Show vibe check server status"

# Test a quick analysis
claude "Quick vibe check: analyze this text for any engineering anti-patterns"

🔍 インストールの確認

# Check Claude Code version and MCP integration
claude --version

# Test the mentor feature (Enhanced in v0.5.1 with MCP sampling)
claude "Should I build a custom HTTP client for the Stripe API?"

# Test fast pattern detection
claude "Quick vibe check issue 42"

GitHub トークンの権限（GitHub 連携用）：

• ✅ repo（プライベートリポジトリへのアクセス用）
• ✅ read:org（組織のリポジトリ用）

トラブルシューティング：

• プライベートリポジトリで「HTTP 404」エラーが発生する：GitHub トークンに repo スコープがあることを確認してください
• MCP サーバーが見つからない：インストール後に Claude Code を再起動してください
• インポートエラー：Python 3.8 以降がインストールされ、依存関係が満たされていることを確認してください

🚀 使用例

🧠 シニアエンジニアのメンター（新機能！）

# Get architectural guidance
"Should I build a custom auth system for this project?"
→ 🤝 Multi-persona feedback from Senior Engineer, Security Expert, Product Manager

# Interrupt mode for real-time prevention
"I'm planning to build a custom HTTP client for the Stripe API"
→ 🚨 INTERRUPT: "Have you checked if stripe-python SDK exists?"

# Claude model selection for different analysis depths
"Use Haiku to quickly validate this API design"
"Use Opus for deep architectural review of this microservice"

自然言語コマンド

# Quick pattern detection (fast)
"Quick vibe check issue 42"
"Fast analysis of this PR"
"Basic check on this technical document"

# Deep analysis with educational coaching
"Deep vibe check issue 42 with full Claude analysis"
"Comprehensive review of this integration plan"
"Analyze this code for over-engineering patterns"

実際の障害を未然に防ぐ

# Before building integrations
"Validate building custom HTTP client for Stripe API"
→ ⚠️ Risk detected: Use stripe-python SDK instead

# During code review
"Review this PR for complexity anti-patterns"
→ 🎓 Educational: Why this abstraction adds unnecessary complexity

# Planning phase analysis
"Analyze issue 23 for infrastructure anti-patterns"
→ 🛡️ Prevention: Research official SDK before building custom solution

📊 Vibe Check が重要な理由

体系的な障害を未然に防ぐ

• Cognee の事例研究：文書化された API を使わず、独自のソリューションを構築したことで、何日もの不要な作業が発生しました
• 業界調査：インテグレーションの失敗の 43% は、実装を伴わないインフラ構築のパターンに起因します
• コスト削減：定期的な利用者では、インテグレーションの失敗が平均 40% 減少します

教育的なアプローチ

問題を指摘するだけのコード分析ツールとは異なり、Vibe Check は次の点を説明します。

• パターンが問題となる理由（実際の事例研究を交えて）
• それらが時間の経過とともに技術的負債をどのように積み重ねるか
• 代わりに何をすべきか（具体的な予防手順を交えて）

🛠️ 45 個以上の MCP ツールを利用可能

コア分析ツール：

セキュリティと設定ツール：

• 設定の検証と診断
• Claude CLI 統合の健全性チェック
• 非同期分析システムの監視
• プロジェクトコンテキストの検出とライブラリのスキャン

コンテキストに応じたドキュメント、破滅的なループの検出、生産性向上のための介入、包括的なデバッグ機能など、合計 45 個以上のツールを利用できます。

🧠 新しいメンターツールの機能：

• 複数のペルソナによる推論：シニアエンジニア、プロダクトマネージャー、セキュリティエキスパートの視点
• 割り込みモード：リアルタイムで誤った判断を防止
• Claude モデルの選択（速度重視の Haiku、バランス重視の Sonnet、深度重視の Opus）
• 複数の質問にわたってコンテキストを維持する協調セッション

📖 ドキュメント

• 使用ガイド - 包括的な例とコマンド
• 技術アーキテクチャ - 実装の詳細と検証
• 製品要件 - ビジョン、市場分析、ロードマップ
• コントリビューションガイド - 新しいパターンや機能への貢献方法

🚀 デプロイ方法

ネイティブ（推奨）

• 起動が高速（約 2 秒）で、メモリ使用量が最小限（約 50MB）
• Claude Code と Python を直接統合

Docker

• 分離された環境でのコンテナデプロイ
• すべての依存関係と環境設定を同梱

ブリッジモード

• 複雑な環境やトラブルシューティング向け
• 詳細なロギングとデバッグ機能

完全なセットアップ手順については、**MCP デプロイガイド**をご覧ください。

🎯 実社会への影響

🧠 シニアエンジニアによるメンタリング（v0.5.1 で MCP サンプリングにより強化）

• 導入前：コストのかかるアーキテクチャ上の決定を一人で行う
• 導入後：方針を決める前に、複数のペルソナからフィードバックを得る
• 効果：割り込みモードにより、私たち自身の開発で、すでに複数のエンジニアリング上の大惨事を防止

技術的負債の防止

• 導入前：チームが何か月もかけて、機能しないカスタムソリューションを構築
• 導入後：計画段階でインフラストラクチャのアンチパターンを見つけ、学習に役立つガイダンスを提供

学習を促すコーチング

• 導入前：プロジェクトをまたいでアーキテクチャ上のミスを繰り返す
• 導入後：実際の失敗事例から、具体的な予防策とともに学ぶ

個人の能力向上

• 導入前：一貫性のないピアレビューのプロセスに頼る
• 導入後：開発ワークフローに組み込まれた個人向けコーチングシステム

🤝 コントリビューション

コントリビューションを歓迎します！Vibe Check MCP は、コミュニティのためにコミュニティが開発しています。

優先度の高いコントリビューション：

• 🎯 新しいアンチパターン検出アルゴリズム
• 📚 学習用コンテンツと実際の事例研究
• 🛠️ MCP ツールの機能強化とパフォーマンス改善

詳細なガイドラインについては、**CONTRIBUTING.md**をご覧ください。

📊 検証と結果

• ✅ 検出精度 87.5%：検証済みパターンテストスイートでの精度
• ✅ 偽陽性 0%：既知の適切なアーキテクチャ上の決定に対して
• ✅ 最適化されたレイテンシ：エンタープライズ対応の効率性
• ✅ 応答時間 <30s：リアルタイムの開発ワークフローに対応
• ✅ ネイティブな MCP プロトコル統合：API キーは不要
• ✅ 45 個以上の専用ツール：包括的な開発ワークフローを支援
• ✅ 事例研究で検証済み：実際のエンジニアリング上の失敗分析に基づく

📄 ライセンス

Apache 2.0 ライセンス — 詳細は LICENSE をご覧ください。

🙏 謝辞

FastMCP を使用して構築され、Claude Code とシームレスに連携できるように設計されています。

次のエンジニアリング上の失敗を防ぐ準備はできていますか？

Vibe Check MCP v0.5.1 をインストールして、災害が起きる前に実際に防いでくれる、コンテキストを理解したシニアエンジニアのメンターを活用しましょう。

🚀 今すぐ v0.5.1 を入手 | 📖 リリースノート | 🧠 MCP サンプリング統合を試す

🏆 Vibe Check MCP が市場をリードする理由

ネイティブの MCP サンプリング統合を備えた唯一の AI コーディングアシスタントです。

ネイティブの MCP 統合により、エンタープライズ級の複雑さを伴わずに、エンタープライズ級の AI 支援を利用できます。

間違ったものを作るのはやめましょう。正しいものを、より速く作り始めましょう。

🧪 テスト

Vibe Check MCP には、MCP 統合の E2E テストを含む、包括的なテストカバレッジが備わっています。

前提条件

Python テスト：

pip install -r requirements.txt

Node E2E テスト：

npm install  # Installs mcp-test-client and dependencies

テストの実行

Python 単体テスト：

# Run all tests
pytest

# Run with coverage
pytest --cov=src --cov-report=html

# Run specific test file
pytest tests/unit/test_response_relevance_validator.py -v

Node E2E テスト：

# Run individual E2E tests
node tests/e2e/mcp/mentor_basic.mjs               # Basic mentor functionality
node tests/e2e/mcp/mentor_interrupt_mode.mjs      # Interrupt mode validation
node tests/e2e/mcp/mentor_relevance.mjs           # Response relevance guard

# Run via pytest wrapper (skips if mcp-test-client not installed)
pytest tests/e2e/test_mentor_relevance_e2e.py -v

E2E テストの機能

• PYTHONPATH の自動伝播 — pip install -e . は不要です
• 適切なサーバークリーンアップ — SIGTERM/SIGKILL によるフォールバックで、プロセスの孤立を防ぎます
• 応答の関連性検証 — 定型的または無関係な応答を防ぎます
• Node パッケージがない場合は正常にスキップ — 開発ワークフローを妨げません

テストカバレッジ

トラブルシューティング

MCP サーバーの接続に関する問題

問題： サーバーで log_level validation error または Input should be 'DEBUG', 'INFO', 'WARNING', 'ERROR' or 'CRITICAL' が発生します。

原因： FastMCP は環境変数の検証で大文字と小文字を区別します。LOG_LEVEL=error のような小文字の値は失敗します。

解決方法： .env ファイルで LOG_LEVEL が大文字になっていることを確認してください。

# ❌ This will fail
LOG_LEVEL=error

# ✅ This works
LOG_LEVEL=ERROR

サーバーが起動しない場合

1. Python パスを確認： PYTHONPATH に vibe-check-mcp のソースディレクトリが含まれていることを確認します
2. 依存関係を確認： pip install -r requirements.txt を実行します
3. ログを確認： 起動時の出力に具体的なエラーメッセージがないか確認します
4. 基本的な接続をテスト： python -m vibe_check.server --stdio を直接実行してみます