Predictive Debugger

Predictive Debugger

ウェブサイトとドキュメント：predictivedebugger.dev

JavaScript と TypeScript で発生しそうな実行時エラーを見つける MCP サーバーです。 7 つのツールを使って、コーディングエージェントが型をチェックし、リスクの高いファイルを順位付けし、依存関係をたどり、ログを調べ、行番号と理由を示す独立したモデルレビューを得られます。

インストール済みの Claude Code、Codex、または GitHub Copilot CLI を使用します。 予測呼び出しでは、その CLI のモデルアクセスと利用枠を使用します。別途 API キーを用意する必要はありません。これらの呼び出しにはプロバイダーの利用規約が適用されます。使用前に、特に Claude のサブスクリプションを利用する場合は、規約をご確認ください。プロバイダーの利用規約をご覧ください。

セットアップ

Node.js 22 以降が必要です。モデルによる予測を行うには、対応する CLI を少なくとも 1 つインストールしてサインインしてください。ログ分析用の Python 3 は任意です。

1. MCP サーバーを追加する

以下からエージェントを選択してください。npx がパッケージを自動的にダウンロードして実行します。

claude mcp add --scope project predictive-debugger -- npx -y predictive-debugger@latest

claude mcp add --scope project predictive-debugger -- cmd /d /c npx -y predictive-debugger@latest

codex mcp add predictive-debugger -- npx -y predictive-debugger@latest

codex mcp add predictive-debugger -- cmd /d /c npx -y predictive-debugger@latest

{
  "mcpServers": {
    "predictive-debugger": {
      "command": "npx",
      "args": ["-y", "predictive-debugger@latest"],
      "tools": ["*"]
    }
  }
}

2. 接続を確認する

エージェントを再起動し、/mcp に predictive-debugger と 7 つのツールが表示されることを確認します。 パッケージがダウンロードされることを確認し、バージョンを表示するには、次を実行します。

npx -y predictive-debugger@latest --version

--version を指定せずに実行すると、エージェントからのメッセージを待つ stdio サーバーが起動します。ローカルビルドとトラブルシューティングについては、セットアップのヘルプをご覧ください。

3. エージェントにコードについて質問する

Use Predictive Debugger to find the riskiest files in src/.
Show the imports and tests connected to src/services/orders.ts.
Check src/services/orders.ts for likely runtime failures.
Find unusual entries in logs/app.log.

ツール

まず scan_project と check_types を実行し、そこで見つかったファイルを読みます。 map_dependencies で関連ファイルを特定し、別の意見が必要な場合は predict_failures を使用します。files に複数のパスを渡すと、小さなファイルの モデル呼び出しを上限内でまとめられるため、ファイルごとに CLI のコンテキストを 繰り返し渡さずに済みます。

パラメーター、結果フィールド、制限については、ツールリファレンスを 参照してください。

プライバシーと制限

• 静的解析、依存関係マップ、ログ解析はローカルで実行されます。predict_failures は ソースコードと上限付きの依存関係コンテキストを、お使いの CLI のモデルプロバイダーに 送信します。calleeContext: false を設定すると、依存関係コンテキストを省略できます。
• 認証情報は CLI に保持されます。MCP ツールは、サーバープロセスがアクセスできるパスを 読み取ることができます。プロジェクト単位のセットアップでも、ファイルアクセスは制限 されません。セキュリティモデルを参照してください。
• JSX、TSX、デコレーターを含む JavaScript と TypeScript に対応しています。 Vue と Svelte の単一ファイルコンポーネントには対応していません。4 MB を超える ファイルは拒否されます。大規模な予測では、選択された宣言のみが対象になる場合があります。
• リスクスコアや予測は誤ることがあります。ベンチマークでは 開発用のケースを使用しており、任意のリポジトリでの精度を示すものではありません。
• Windows では手動で検証済みです。CI では Node 22 と 24 を使用して Windows、macOS、 Linux を対象にしていますが、macOS と Linux で実際の CLI をインストールしての手動検証は 行っていません。

VS Code プレビュー

未完成の拡張機能で、問題パネルに検出結果を表示できます。ローカルでのビルドが必要で、 Marketplace やビルド済みの VSIX としては提供されていません。 拡張機能を試す方法を参照してください。

ドキュメント

• predictivedebugger.dev：ウェブサイト、クイックスタート、ガイド。
• 詳細なセットアップ：プロバイダーへのログイン、プロジェクトの範囲、更新、ローカルビルド。
• ツールリファレンス：パラメーター、予測結果、依存関係コンテキスト、スコアリング。
• VS Code プレビュー：開発ホスト、コマンド、設定。
• ベンチマークと手法。
• 開発とコントリビューション。バグ報告を歓迎します。コードのコントリビューションはまだ受け付けていません。
• セキュリティポリシー。脆弱性は非公開で報告してください。

ライセンス

MIT。