llms.txt: machine-readable documentation index. Markdown version of this page is also available.

CLion 2026.3 Help

MCP サーバー

バージョン 2025.2 以降、CLion には統合された MCP サーバー が付属しており、Claude Code、Codex、VS Code などの外部クライアントから IDE が提供するツールにアクセスできます。 これにより、ユーザーは好みのアプリケーションを離れることなく JetBrains IDE を制御し、操作できるようになります。

MCP サーバープラグインを有効化する

この機能は、MCP サーバープラグインに依存しており、CLion にはデフォルトで同梱され有効化されています。 関連機能が利用できない場合は、プラグインを無効化していないことを確認してください。

  1. Ctrl+Alt+S を押して設定を開き、 プラグイン を選択します。

  2. MCP サーバー プラグインを見つけて、 有効化 をクリックします。

MCP サーバー有効化

MCP サーバーを有効化するには、次の手順に従います。

  1. 設定 | AI | MCP サーバー に進みます。

  2. MCP サーバー有効化 チェックボックスを選択します。

  3. MCP サーバーを有効化しますか? ダイアログで、サードパーティアプリケーションが IDE で開かれたプロジェクトに対してどのアクセス権を取得するかを確認し、 有効化 をクリックして続行します。

  4. 変更を適用 をクリックします。

MCP サーバーが有効化されたら、外部クライアントの構成に進めます。

外部クライアントのセットアップ

検出された Junie、 VS Code、 Claude Code、 Codex、 Air、 GitHub Copilot CLI などの外部クライアントでは、構成を自動的に実行できます。 クライアントの設定とは、IDE MCP サーバーのアドレスをそのクライアントの構成ファイルに追加することです。

これを行うには、次の手順を実行します。

  1. 設定 | AI | MCP サーバー に進みます。

  2. クライアントの自動構成 セクションで、MCP サーバーで使用するために設定したい各クライアントの 自動構成 をクリックします。 これにより、クライアントの構成ファイルが自動的に更新されます。 設定済みトランスポートのセットはクライアントによって異なります。

    MCP サーバー設定

    特定のトランスポートを自分で構成するには、 自動構成 の横にある をクリックし、リストから必要なオプションを選択します。

    構成オプション
  3. 構成を有効にするにはクライアントを再起動してください。

プロジェクトレベルのクライアント設定ル 3},{

一部のクライアントは、プロジェクトの作業ディレクトリから構成ファイルも読み取ります。 これらのクライアントでは、IDE が現在開いているプロジェクト内の構成ファイルに接続設定を直接書き込むことができるため、MCP サーバーはそのプロジェクトで作業している間だけ使用できます。

複数のプロジェクトを扱っていて、各クライアントセッションに MCP サーバーを登録したくない場合は、このオプションを使用します。

  1. 設定 | AI | MCP サーバー に進みます。

  2. プロジェクトクライアントの自動構成 セクションで、設定する各クライアントの 自動構成 をクリックします。 これにより、クライアントのプロジェクトレベル構成ファイルが自動的に更新されます。

    クライアントのプロジェクトレベル構成を自動設定する

    特定のトランスポートメカニズムを構成する場合は、 自動構成 の横にある をクリックし、リストから必要なオプションを選択します。

  3. 構成を有効にするにはクライアントを再起動してください。

手動クライアントセットアップ

接続したいクライアントがリストにない場合は、手動で構成します。

  1. 手動クライアント構成 セクションで、接続タイプに応じて SSE 設定をコピー、 標準入出力設定をコピーする 、または HTTP ストリーム構成のコピー をクリックします。

    MCP サーバーの手動設定
  2. コピーした構成をクライアントの設定または構成ファイルに貼り付けます。

  3. 構成を有効にするにはクライアントを再起動してください。

確認なしでアクションを実行する

MCP サーバーを使用すると、接続された外部クライアントは、毎回ユーザーに確認を求めることなく、ターミナルコマンドを実行したり、IDE で構成を実行したりできます。

このモードを有効にするには:

  1. 設定 | AI | MCP サーバー に進みます。

  2. コマンド実行 セクションで、 確認なしでシェルコマンドまたは実行構成を実行する (勇敢なモード) 設定を有効にします。

  3. 変更を適用 をクリックします。

ターミナルセッションでセットアップ候補を表示する

Codex または Claude が一致する MCP サーバーセットアップなしでターミナルセッションで起動した場合、IDE は接続の構成を提案するバナーを表示できます。

この動作を制御するには、次の手順に従います。

  1. 設定 | AI | MCP サーバー に進みます。

  2. ターミナルセッション セクションで、 Codex および Claude ターミナルセッション向けセットアップの提案を表示する チェックボックスを選択または選択解除します。

  3. 変更を適用 をクリックします。

サポートされているツール

MCP サーバーは、外部クライアントが IDE やプロジェクトとやりとりできる一連のツールを公開しています。例えば、コードの解析、ファイルの変更、実行構成の実行、またはターミナルコマンドの実行などが可能です。

設定 | AI | MCP サーバー | Exposed ツール で利用可能なツールの一覧を閲覧・管理できます。 各ツールについて、 有効化 チェックボックスを選択または選択解除して、そのツールを外部クライアントに公開するかどうかを制御します。

Exposed ツール設定ページ

ツールの ルーター専用 チェックボックスを選択することもできます。 ルーター専用ツールは直接の MCP ツールリストから非表示になり、専用ルーター ツール からのみ使用できます。 これにより、不要なツールの説明がツールリストに表示されなくなり、コンテキストを節約できます。 以下に対してルーター専用モードを有効化 設定を使用して、ルーター専用モードを適用するタイミングを指定します。例: すべてのエージェント 、または ACP エージェントのみ。

以下は、MCP サーバーによって提供されるツールのリストです。

解析ツールセット

analyze_calls

メソッド、関数、コンストラクター、またはサポートされている型に対応した IDE の呼び出し階層ツリーを構築します。 これを使用すると、シンボルを呼び出している側 (INCOMING_CALLS) またはシンボルが呼び出している対象 (OUTGOING_CALLS) を確認できます。

実際の呼び出しに基づいて依存関係を評価する場合は、使用箇所検索、テキスト検索、正規表現検索よりもこのツールを優先してください。 IDE の呼び出し階層データを使用するため、基本的な検索よりもノイズや追加の呼び出しが少なく、より正確な呼び出し関係を提供します。

symbolFqn を完全修飾名として渡します。例: com.example.Service.run。 名前があいまいな場合、ツールは正確なシグネチャーを返します。そのいずれかを symbolFqn として渡し返してください。 短い名前または断片しか分からない場合は、まず シンボルの検索 を使用してターゲットを見つけます。

結果は展開可能なテキストツリーです。 各ノードには filePath と treePath が含まれます。 filePath は可能な場合、プロジェクト相対になります。 treePath を渡し直してサブツリーをレンダリングします。 childOffset を使用して、切り詰められた … の後から続行します… さらに n 件 行。 depth、 maxChildren 、および maxNodes はレンダリングされるツリーの範囲を制限します。 IDE が解決できる場合、シンボルはプロジェクトソース、ソース jar、または逆コンパイルされたバイナリ jar 依存関係から取得できます。

パラメーター:

  • symbolFqn (必須): プレーンな完全修飾シンボル名、またはあいまいさエラーで返された正確なシグネチャーやレンダリングされた子ノードからコピーした正確なシグネチャー。 短い名前または断片しか分からない場合は、まず シンボルの検索 を使用し、最適な完全修飾呼び出し可能名をここに渡します。 例: com.example.Service.run、 com.example.Service.run(String) 、または org.assertj.core.api.Assertions.assertThat(String)。 ファイルパス、行、列、または別のターゲットシグネチャーは渡さないでください。

  • analysisKind (必須): 呼び出し分析の方向。 INCOMING_CALLS を使用して symbolFqn の呼び出し元を表示するか、 OUTGOING_CALLS を使用して symbolFqn から呼び出されるシンボルを表示します。

  • depth: 要求されたサブツリールートの下にレンダリングする呼び出しレベルの最大数。 デフォルトは 5 です。 サブツリールートのみをレンダリングするには 0 を使用します。

  • maxChildren: 各ノードにレンダリングされる直接の子の最大数。 デフォルトは 50 です。

  • maxNodes: レンダリングされる呼び出しノードの合計最大数。 デフォルトは 1000 です。

  • treePath: サブツリールートへの任意のパス。以前の analyze_calls の結果から正確にコピーします。 Null または省略された場合は、ルートパス [] を意味します。 各コンポーネントは正確なシグネチャーであり、表示名ではありません。

  • childOffset: treePath で指定されたノードの直接の子をページングするためのオフセット。 デフォルトは 0 です。

  • timeout: タイムアウト(ミリ秒)。

  • projectPath: プロジェクトパス。 曖昧な呼び出しを減らすため、この値がわかっている場合は必ずこの値を指定してください。 現在の作業ディレクトリのみがわかっている場合は、それをプロジェクトパスとして使用できます。

ビルドプロジェクト

プロジェクトまたは指定ファイルのビルドをトリガーし、補完を待ってビルドエラーを返します。 このツールを使うことで、プロジェクトをビルドまたはファイルをコンパイルし、コンパイルエラーや警告の詳細を確認できます。

編集を行った後は、このツールで編集内容が有効かどうか検証する必要があります。

パラメーター:

  • rebuild: プロジェクト全体を再ビルドするかどうか。 デフォルトは false です。 filesToRebuild が指定されていない場合のみ有効です。

  • filesToRebuild: 指定された場合、そのパスのファイルのみをコンパイルします。 パスはプロジェクトルートからの相対パスです。

  • timeout: タイムアウト(ミリ秒)。

  • projectPath: プロジェクトパス。 曖昧な呼び出しを減らすため、この値がわかっている場合は必ずこの値を指定してください。 現在の作業ディレクトリのみがわかっている場合は、それをプロジェクトパスとして使用できます。

ファイルの問題を取得

IntelliJ インスペクションを使用して、指定されたファイルのエラーと警告を分析します。 このツールを使用すると、特定のファイル内のコーディングの問題、構文エラー、その他の問題を特定できます。

重大度、説明、場所の情報を含む問題のリストを返します。

パラメーター:

  • filePath: プロジェクトルートからの相対パス。

  • errorsOnly: エラーのみを含めるか、エラーと警告の両方を含めるか。

  • timeout: タイムアウト(ミリ秒)。

  • projectPath: プロジェクトパス。 曖昧な呼び出しを減らすため、この値がわかっている場合は必ずこの値を指定してください。 現在の作業ディレクトリのみがわかっている場合は、それをプロジェクトパスとして使用できます。

プロジェクトの依存関係を取得

プロジェクトで定義されているすべての依存関係のリストを返します。 ライブラリ名に関する構造化された情報を提供します。

パラメーター:

  • projectPath: プロジェクトパス。 曖昧な呼び出しを減らすため、この値がわかっている場合は必ずこの値を指定してください。 現在の作業ディレクトリのみがわかっている場合は、それをプロジェクトパスとして使用できます。

プロジェクトモジュールを取得

プロジェクト内のすべてのモジュールとそのタイプをリスト形式で返します。 各モジュールの名前やタイプなど、構造化された情報を提供します。

パラメーター:

  • projectPath: プロジェクトパス。 曖昧な呼び出しを減らすため、この値がわかっている場合は必ずこの値を指定してください。 現在の作業ディレクトリのみがわかっている場合は、それをプロジェクトパスとして使用できます。

lint_files

IntelliJ インスペクションを使用して、指定されたファイルのエラーと警告を分析します。 編集後に複数のファイルを lint するには、このツールを使用します。 ファイルごとの問題を、重大度、説明、場所の情報とともに返します。

個々のファイルが利用可能な予算を超えた場合、バッチ応答には timedOut: true と空の problems を持つファイルエントリが含まれることがあります。 notAnalyzedReason を持つファイルエントリは、分析できなかったファイルを示します。たとえば、プロジェクトコンテンツルート外のファイル、除外されたファイル、サポートされていないファイルタイプなどです。 トップレベルの more: true は、バッチが不完全であることを意味します。

パラメーター:

  • files (必須): 分析するプロジェクト相対ファイルのリスト。 重複するパスは正規化後に無視されます。

  • min_severity: 含める最小重大度: warning または error。 デフォルトは warning です。

  • timeout: タイムアウト(ミリ秒)。

  • projectPath: プロジェクトパス。 曖昧な呼び出しを減らすため、この値がわかっている場合は必ずこの値を指定してください。 現在の作業ディレクトリのみがわかっている場合は、それをプロジェクトパスとして使用できます。

コードインサイトツール

シンボル情報を取得

指定されたファイル内の指定された位置にあるシンボルに関する情報を取得します。 IntelliJ IDEA の クイックドキュメント 機能と同じ情報を提供します。 この情報には、プログラミング言語に応じて、シンボルの名前、シグネチャー、型、ドキュメント、その他の詳細が含まれる場合があります。

位置がシンボルを参照している場合、ツールはシンボルの宣言(存在する場合)を含むコードスニペットを返します。 このツールを使用して、シンボルの宣言、セマンティクス、位置を理解してください。

パラメーター:

  • filePath: プロジェクトルートからの相対パス。

  • line: 1 から始まる行番号。

  • column: 1 から始まる列番号。

  • projectPath: プロジェクトパス。 曖昧な呼び出しを減らすため、この値がわかっている場合は必ずこの値を指定してください。 現在の作業ディレクトリのみがわかっている場合は、それをプロジェクトパスとして使用できます。

データベース固有のツール

AI エージェントに対して厳密に読み取り専用アクセスを保証するには、適切な制限(読み取り専用)権限を持つデータベースユーザーを使用し、データソースがそのユーザーを使用するように構成します。

SQL クエリをキャンセル

実行中のクエリを、その固有 ID を使用してキャンセルします。

パラメーター:

  • sessionId: クエリセッション ID。

データベース接続の作成

名前、DBMS (dbms )、JDBC URL (url )、および接続を確認するフラグ (needToCheckDs) に基づいて、新しいデータベース接続 (データソース) を作成します。 すべてのパラメーターが必須です。 接続診断情報を返します。

パラメーター:

  • name (必須): データベース接続の一意の名前。

  • dbms: データベース管理システム (DBMS) の名前。

  • url: データベース接続の完全な JDBC URL。例: jdbc:postgresql://<host>:<port>/<database>。

  • needToCheckDs: データソースの作成または編集直後に接続をテストするかどうか。 複数の接続をバッチで構成する場合は false に設定します。接続ごとのプローブは高コストであり、重要な接続については データベース接続をテスト を明示的に呼び出すことができます。

  • projectPath: プロジェクトパス。 曖昧な呼び出しを減らすため、この値がわかっている場合は必ずこの値を指定してください。 現在の作業ディレクトリのみがわかっている場合は、それをプロジェクトパスとして使用できます。

データベース接続の編集

connectionId で識別される既存のデータベース接続 (データソース) を編集します。 接続の DBMS ドライバーと JDBC URL を更新します。接続 name は保持されます。 接続診断情報を返します。

パラメーター:

  • connectionId: 固有の接続 ID。

  • dbms: データベース管理システム (DBMS) の名前。

  • url: データベース接続の完全な JDBC URL。例: jdbc:postgresql://<host>:<port>/<database>。

  • needToCheckDs: データソースの作成または編集直後に接続をテストするかどうか。 複数の接続をバッチで構成する場合は false に設定します。接続ごとのプローブは高コストであり、重要な接続については データベース接続をテスト を明示的に呼び出すことができます。

  • projectPath: プロジェクトパス。 曖昧な呼び出しを減らすため、この値がわかっている場合は必ずこの値を指定してください。 現在の作業ディレクトリのみがわかっている場合は、それをプロジェクトパスとして使用できます。

SQL クエリを実行

指定されたデータベース接続に対して SQL クエリを実行します。

このツールは実行ステータス(成功またはエラー)を報告します。 エラーが発生した場合は、エラーの説明も提供します。

クエリがデータを返した場合、そのデータは CSV フォーマットでツールの応答に追加されます。

パラメーター:

  • connectionId: 固有の接続 ID。

  • queryText: 実行する SQL クエリ。

クエリ結果の取得

指定された行オフセットから、実行済みクエリの ID によって行を取得します。 SQL クエリを実行 と同じ形で返します: resultSetId と CSV フォーマットでレンダリングされた結果です。

以前に SQL クエリを実行 または テーブルデータをプレビュー によって返された resultSetId をページングするには、このツールを使用します。

パラメーター:

  • resultSetId (必須): 以前の SQL クエリを実行 または テーブルデータをプレビュー 呼び出しによって返された不透明な結果セット ID。

  • offset (必須): 取得を開始する行オフセット。 デフォルトは 0 です。

  • projectPath: プロジェクトパス。 曖昧な呼び出しを減らすため、この値がわかっている場合は必ずこの値を指定してください。 現在の作業ディレクトリのみがわかっている場合は、それをプロジェクトパスとして使用できます。

データベースオブジェクト説明の取得

特定のスキーマ内にあるデータベースオブジェクト(カラム、型、キー、インデックスなど)の構造を階層化テキストで取得します。

曖昧な場合は、該当するすべてのオブジェクトの定義を返します。

パラメーター:

  • connectionId: 固有の接続 ID。

  • databaseName: スキーマが属するデータベースの名前。 DBMS にデータベースがなく、スキーマのみが存在する場合は、空欄にすることができます。

  • schemaName: スキーマ名。

  • kind: このパラメーターに特定のオブジェクト種別コードを設定すると、その種別のオブジェクトのみが一覧表示されます。 null に設定すると、スキーマ内のすべてのオブジェクトが取得されます。

  • objectName: 指定した種類のオブジェクトの命名(例:テーブル名やビュー名)。 空にすることはできません。

  • projectPath: プロジェクトパス。 曖昧な呼び出しを減らすため、この値がわかっている場合は必ずこの値を指定してください。 現在の作業ディレクトリのみがわかっている場合は、それをプロジェクトパスとして使用できます。

スキーマのイントロスペクト

データベーススキーマをイントロスペクトし、そのメタデータ (テーブル、列、インデックス) をローカルモデルに読み込みます。 スキーマの isIntrospected フラグが false で、スキーマの構造を調査する必要がある場合、または古いメタデータを更新する場合に使用します。 更新されたイントロスペクションステータスを持つスキーマ識別子を返します。

パラメーター:

  • connectionId: 固有の接続 ID。

  • databaseName: スキーマが属するデータベースの名前。 DBMS にデータベースがなく、スキーマのみが存在する場合は、空欄にすることができます。

  • schemaName: スキーマ名。

  • projectPath: プロジェクトパス。 曖昧な呼び出しを減らすため、この値がわかっている場合は必ずこの値を指定してください。 現在の作業ディレクトリのみがわかっている場合は、それをプロジェクトパスとして使用できます。

データベース接続を一覧表示

プロジェクト内で設定済みのデータベース接続またはデータソースのリストを取得します。 各接続について、一意の ID、名前、DBMS、ドライバ名が返されます。

データベーススキーマを一覧表示

指定されたデータベース接続内のデータベーススキーマのリストを取得します。

このツールは、各スキーマについて、スキーマ名とデータベース名(該当しない場合は空欄)を返します。

パラメーター:

  • connectionId: 固有の接続 ID。

  • selectedOnly: データベースツリーで選択されたスキーマのみを表示する場合は true、すべてのスキーマを表示する場合は false。

最近の SQL クエリを一覧表示

この機能は無料プランではご利用いただけません。

指定されたデータベース接続に対して、最近実行されたクエリ(現在実行中のクエリを含む)のリストを取得します。

各クエリの戻り値:

  • クエリセッションの一意の ID。

  • クエリの実行にかかった時間(ミリ秒)。

  • クエリの現在の状態。 例: 実行中、キャンセル中、完了など。

  • クエリの補完ステータス。 例: 成功、エラーで終了、キャンセルなど。

  • クエリのテキスト。

パラメーター:

  • connectionId: 固有の接続 ID。

スキーマオブジェクトの種類を一覧表示

指定されたデータベース接続でサポートされているスキーマオブジェクトの種類の一覧を取得します。 各オブジェクトの種類について、そのオブジェクト種類の一意のコードと人間が読みやすい名前を返します。

パラメーター:

  • connectionId: 固有の接続 ID。

スキーマオブジェクトを一覧表示

指定されたスキーマ内のデータベースオブジェクトのリストを取得します。 各オブジェクトについて、スキーマ内の命名および種類を返します。

パラメーター:

  • connectionId: 固有の接続 ID。

  • schemaName: スキーマ名。

  • databaseName: スキーマが属するデータベースの名前。 DBMS にデータベースがなく、スキーマのみが存在する場合は、空欄にすることができます。

  • kind: このパラメーターに特定のオブジェクト種別コードを設定すると、その種別のオブジェクトのみが一覧表示されます。 null に設定すると、スキーマ内のすべてのオブジェクトが取得されます。

テーブルデータをプレビュー

指定されたデータベース接続を使用して、テーブル、ビュー、マテリアライズドビュー、その他のテーブルのようなオブジェクトのプレビューデータを返します。

このツールは、テーブルの内容を CSV 形式で返します。

パラメーター:

  • connectionId: 固有の接続 ID。

  • schemaName: スキーマ名。

  • databaseName: スキーマが属するデータベースの名前。 DBMS にデータベースがなく、スキーマのみが存在する場合は、空欄にすることができます。

  • tableName: テーブル名。

  • maxRowCount: 返される行の最大数。 デフォルトは 100 です。

データベース接続をテスト

接続診断情報を返します。

  • 接続に問題があるかどうかを示すフラグ: はい、いいえ、不明。

  • DBMS の種類、バージョン、JDBC ドライバーなど、データベース接続に関する詳細情報。

  • 接続試行結果の概要。 接続に失敗した場合は、DBMS が提供するエラー説明が含まれます。

パラメーター:

  • id: 固有の接続 ID。

デバッガーツール

これらのツールにより、外部クライアントは IDE のデバッガーを制御できます。ブレークポイントの設定、一覧表示、削除、デバッグセッションの開始とステップ実行、実行時のコールスタック、スレッド、変数値の調査を行えます。

xdebug_control_session

デバッグセッションの実行を制御します。 コードのステップ実行、実行の再開、一時停止、またはデバッグセッションの停止には、このツールを使用します。

前提条件:

  • デバッグセッションが存在している必要があります。

  • STEP_* および RESUME には一時停止中のセッションが必要です。

アクション:

  • STEP_INTO: 次のメソッド呼び出しにステップイン

  • STEP_OVER: 現在の行をステップオーバー

  • STEP_OUT: 現在のメソッドからステップアウト

  • RESUME: 次のブレークポイントまでプログラムの実行を再開

  • PAUSE: プログラムの実行を一時停止

  • STOP: デバッグセッションを停止

  • WAIT_FOR_PAUSE: セッションが一時停止するまで待機 (ブレークポイントにヒット、または手動で一時停止)

  • DRAIN_EVENTS: セッションのトレースポイント出力をドレイン (ブレークポイントエラーはすべてのアクションでドレインされます)

重要な注意事項:

  • プログラムが実行中の場合は、 WAIT_FOR_PAUSE または PAUSE を STEP_*/RESUME の前に使用します。

  • xdebug のデバッガーステータス取得 または xdebug のデバッガーセッション開始 から現在の sessionId を使用します。 セッションが停止、タイムアウト、または消失した場合は、次のセッションスコープの呼び出しの前にセッションリストを更新します。

  • RESUME はブレークポイントを設定しません。 有効なブレークポイントがない場合 (または次にヒットするものがない場合)、プログラムは最後まで実行され、一時停止せずにセッションが停止することがあります。

  • RESUME の後、 WAIT_FOR_PAUSE を呼び出して次の一時停止を確認します。 WAIT_FOR_PAUSE がタイムアウトした場合は、 PAUSE を検討し、ブレークポイントを再確認してください。

  • DRAIN_EVENTS にも既存のセッションが必要です。セッションが終了した後は、古い sessionId を再利用しないでください。

次の呼び出し:

結果内のステータス値:

  • running: プログラムを実行中

  • 一時停止: 実行は中断されています (ブレークポイント、ステップ、または手動一時停止)。一時停止の結果には、利用可能な場合は frameValues、 xdebug_get_frame_values(depth=0) フォーマットの現在のフレームのスナップショットも含まれます

  • 停止済み: デバッグセッションは終了しました

  • breakpointErrorsTail はどのアクションでも返されます

  • tracepointOutputsTail は DRAIN_EVENTS の場合にのみ返されます

イベントサポートスコープ:

  • ブレークポイントエラーとトレースポイント出力イベントは、現在 JVM ベースのデバッガー (Java、Kotlin など) でのみ報告されます。

  • その他のデバッガーバックエンドでは、ブレークポイント/ログ記録が構成されていても、これらのイベント末尾が空になることがあります。

パラメーター:

  • sessionId: デバッグセッション ID。 xdebug のデバッガーステータス取得 または xdebug のデバッガーセッション開始 から返された現在の ID を使用します。 セッションが停止、タイムアウト、または消失した場合は、古い ID を再利用する前にセッションリストを更新してください。 フォーマット: デフォルトではセッション名を ID として使用します。同じ名前を共有するセッションが複数ある場合、ID は <sessionName>#<executionId> です。 null で、アクティブなセッションがひとつだけ存在する場合は、自動的に選択されます。 複数のセッションがアクティブで、 sessionId が省略されている場合、呼び出しは失敗します。 デフォルト: null。

  • action: 実行するアクション: STEP_INTO、 STEP_OVER、 STEP_OUT、 RESUME、 PAUSE、 STOP、 WAIT_FOR_PAUSE、 DRAIN_EVENTS。 イベントドレインは、現在 JVM ベースのデバッガー (Java、Kotlin など) でのみ設定されます。

  • timeout: アクション完了を待機するミリ秒単位のタイムアウト。 ガイダンス: STEP_*/PAUSE は通常 5000-15000。 WAIT_FOR_PAUSE はワークロードとブレークポイントに応じて通常 30000-120000。 デフォルト: 30000。

  • eventsLimit: イベントリストごとにドレインする最新イベントの最大数。 DRAIN_EVENTS では、この制限は breakpointErrorsTail と tracepointOutputsTail に個別に適用されます。 デフォルト: 100。

  • clearEventsAfterRead: 互換性フラグ。 返されたイベントは、この値に関係なく常に内部バッファーから削除されます。

  • projectPath: プロジェクトパス。 曖昧な呼び出しを減らすため、この値がわかっている場合は必ずこの値を指定してください。 現在の作業ディレクトリのみがわかっている場合は、それをプロジェクトパスとして使用できます。

xdebug_evaluate_expression

現在のスタックフレームのコンテキストで式を評価します。 デバッグ中に値の計算、メソッドの呼び出し、または式の検査を行うには、このツールを使用します。

前提条件:

  • セッションは中断されている必要があります。

  • 選択したフレーム/言語で評価がサポートされている必要があります。

  • expression は、現在のフレームの言語で有効な式である必要があります。

結果は次の形式で返されます:

  • depth == 0: 評価された式の表示のみ

  • depth > 0: 表示に加えて、要求された深さまでの子の疑似グラフィックツリー

入力ルール:

  • デバッガー評価器が解析する必要があるとおりに、生の式テキストを渡します。

  • JSON エスケープされたペイロードや、 \\"text\\" などのリテラルエスケープシーケンスは渡さないでください。

次の呼び出し:

パラメーター:

  • sessionId: デバッグセッション ID。 xdebug のデバッガーステータス取得 または xdebug のデバッガーセッション開始 から返された現在の ID を使用します。 セッションが停止、タイムアウト、または消失した場合は、古い ID を再利用する前にセッションリストを更新してください。 フォーマット: デフォルトではセッション名を ID として使用します。同じ名前を共有するセッションが複数ある場合、ID は <sessionName>#<executionId> です。 null で、アクティブなセッションがひとつだけ存在する場合は、自動的に選択されます。 複数のセッションがアクティブで、 sessionId が省略されている場合、呼び出しは失敗します。 デフォルト: null。

  • frameIndex: 整数としてのスタックフレームインデックス (0 = 最上位フレーム)。 現在一時停止中の xdebug のスタック取得 結果から取得します。 RESUME、 STEP_*、 xdebug_run_to_line 、または一時停止位置の変更後は、キャッシュされたフレームインデックスを再利用しないでください。 null の場合、最上位フレームを使用します。 デフォルト: null。

  • expression: 現在のコンテキストで評価する式。 現在のフレームの言語で生の式テキストを渡します。JSON エスケープされたペイロードや、リテラルのバックスラッシュでエスケープされた引用符付きテキストは渡さないでください。

  • depth: 評価結果の子を展開する最大深さ (0 = 値のみ、1 = 直接の子、2 = 子 + 孫など)。 デフォルト: 0。

  • projectPath: プロジェクトパス。 曖昧な呼び出しを減らすため、この値がわかっている場合は必ずこの値を指定してください。 現在の作業ディレクトリのみがわかっている場合は、それをプロジェクトパスとして使用できます。

xdebug_get_debugger_status

実行中のすべてデバッグセッションを含む、デバッガーの現在のステータスを返します。 実行中のすべてのデバッグセッションとその状態の概要を取得するには、このツールを使用します。

前提条件:

  • なし

明示的な sessions[] と activeSessionId を返します。

次の呼び出し:

  • 実行中のセッションがない場合は、 xdebug のデバッガーセッション開始 を呼び出します。

  • 複数のセッションがアクティブな場合は、返された id を後続の呼び出しで sessionId として使用します。

パラメーター:

  • projectPath: プロジェクトパス。 曖昧な呼び出しを減らすため、この値がわかっている場合は必ずこの値を指定してください。 現在の作業ディレクトリのみがわかっている場合は、それをプロジェクトパスとして使用できます。

xdebug_get_frame_values

指定されたスタックフレーム内で表示されている値をツリー構造で返します。 コールスタック内の特定のポイントで利用可能なローカル変数、パラメーター、フィールド、またはその他の値を検査するには、このツールを使用します。

前提条件:

  • セッションは中断されている必要があります。

  • フレームインデックスは、現在一時停止中の xdebug のスタック取得 結果から取得する必要があります (0 = 最上位フレーム)。

書式:

  • 子を持つノードは + でマークされます。

次の呼び出し:

  • ネストされたフィールドを掘り下げるには、 xdebug のパスによる値取得 を使用します。

  • 同じフレームで計算によるチェックを行うには、 xdebug の式評価 を使用します。

  • キャッシュされた frameIndex は、 RESUME、 STEP_*、 xdebug_run_to_line 、または一時停止位置の変更後に再利用しないでください。

パラメーター:

  • sessionId: デバッグセッション ID。 xdebug のデバッガーステータス取得 または xdebug のデバッガーセッション開始 から返された現在の ID を使用します。 セッションが停止、タイムアウト、または消失した場合は、古い ID を再利用する前にセッションリストを更新してください。 フォーマット: デフォルトではセッション名を ID として使用します。同じ名前を共有するセッションが複数ある場合、ID は <sessionName>#<executionId> です。 null で、アクティブなセッションがひとつだけ存在する場合は、自動的に選択されます。 複数のセッションがアクティブで、 sessionId が省略されている場合、呼び出しは失敗します。 デフォルト: null。

  • frameIndex: 整数としてのスタックフレームインデックス (0 = 最上位フレーム)。 現在一時停止中の xdebug のスタック取得 結果から取得します。 RESUME、 STEP_*、 xdebug_run_to_line 、または一時停止位置の変更後は、キャッシュされたフレームインデックスを再利用しないでください。 null の場合、最上位フレームを使用します。 デフォルト: null。

  • depth: 評価結果の子を展開する最大深さ (0 = 値のみ、1 = 直接の子、2 = 子 + 孫など)。 デフォルト: 0。

  • projectPath: プロジェクトパス。 曖昧な呼び出しを減らすため、この値がわかっている場合は必ずこの値を指定してください。 現在の作業ディレクトリのみがわかっている場合は、それをプロジェクトパスとして使用できます。

xdebug_get_stack

デバッグセッション内のスレッドのコールスタックを返します。 現在の実行ポイントに至ったメソッド呼び出しのシーケンスを確認するには、このツールを使用します。

前提条件:

  • セッションは中断されている必要があります。

振る舞い:

  • threadId は xdebug のスレッド取得 から取得する必要があり、デバッガーのスレッド表示名と一致します (デフォルトはアクティブなスレッド)。

  • ソース位置がない場合でもフレームを含めます (ファイル/line は null の場合があります)。

ページネーション:

  • offset/limit は、スタック全体を収集した後に適用されます。

フレームフィールドには次が含まれます:

  • index

  • ファイル

  • line

  • isCurrent

  • presentation

ファイル はデバッガーから提供されたとおりに報告されます (パスの正規化なし)。

次の呼び出し:

パラメーター:

  • sessionId: デバッグセッション ID。 xdebug のデバッガーステータス取得 または xdebug のデバッガーセッション開始 から返された現在の ID を使用します。 セッションが停止、タイムアウト、または消失した場合は、古い ID を再利用する前にセッションリストを更新してください。 フォーマット: デフォルトではセッション名を ID として使用します。同じ名前を共有するセッションが複数ある場合、ID は <sessionName>#<executionId> です。 null で、アクティブなセッションがひとつだけ存在する場合は、自動的に選択されます。 複数のセッションがアクティブで、 sessionId が省略されている場合、呼び出しは失敗します。 デフォルト: null。

  • threadId: スタックを取得するスレッド ID。 この値は xdebug のスレッド取得 から取得する必要があり、不透明な数値 ID ではなく、デバッガーのスレッド表示名と一致します。 指定しない場合、現在/アクティブなスレッドを使用します。 デフォルト: null。

  • limit: 返す最大フレーム数。 デフォルト: 200。

  • offset: ページオフセット。 デフォルト: 0。

  • projectPath: プロジェクトパス。 曖昧な呼び出しを減らすため、この値がわかっている場合は必ずこの値を指定してください。 現在の作業ディレクトリのみがわかっている場合は、それをプロジェクトパスとして使用できます。

xdebug_get_threads

デバッグセッション内のスレッドの一覧を返します。 すべてのスレッドとその現在のステータスを確認するには、このツールを使用します。

前提条件:

  • セッションは中断されている必要があります。

次の呼び出し:

ページネーション:

  • offset/limit は、すべてのスタックを収集した後に適用されます。

順序:

  • アクティブなスレッドが先頭。

  • 残りのスレッドは、スタック深度の降順で並べ替えられます。

スキーマフィールドには次が含まれます:

  • id

  • name

  • state

  • isCurrent

  • additionalInfo

  • additionalInfoTooltip

  • frameCount

additionalInfo/additionalInfoTooltip は、利用可能な場合は追加の表示情報を使用します。

パラメーター:

  • sessionId: デバッグセッション ID。 xdebug のデバッガーステータス取得 または xdebug のデバッガーセッション開始 から返された現在の ID を使用します。 セッションが停止、タイムアウト、または消失した場合は、古い ID を再利用する前にセッションリストを更新してください。 フォーマット: デフォルトではセッション名を ID として使用します。同じ名前を共有するセッションが複数ある場合、ID は <sessionName>#<executionId> です。 null で、アクティブなセッションがひとつだけ存在する場合は、自動的に選択されます。 複数のセッションがアクティブで、 sessionId が省略されている場合、呼び出しは失敗します。 デフォルト: null。

  • limit: ページサイズ。 デフォルト: 50、最大: 200。

  • offset: ページオフセット。 デフォルト: 0。

  • projectPath: プロジェクトパス。 曖昧な呼び出しを減らすため、この値がわかっている場合は必ずこの値を指定してください。 現在の作業ディレクトリのみがわかっている場合は、それをプロジェクトパスとして使用できます。

xdebug_get_value_by_path

プロパティ名のパスをたどって、ネストされたオブジェクトの値を取得します。 複雑なオブジェクトを掘り下げ、そのネストされたプロパティを検査するには、このツールを使用します。

前提条件:

  • セッションは中断されている必要があります。

  • パスは空でなく、選択したフレーム/オブジェクト内で表示される名前を参照している必要があります。

結果は次の形式で返されます:

  • depth == 0: 指定されたパスにある値の表示のみ

  • depth > 0: 値の表示に加えて、要求された深さまでの子の疑似グラフィックツリー

例:

  • obj.field.subField の値を取得するには、 path = ["obj", "field", "subField"] を使用します。

  • 配列/リストインデクサーの場合は、インデックストークンを通常のパス要素 (子の名前) として渡します。例: items[0].name-> path = ["items", "[0]", "name"]。

  • インデックスノード名は言語/デバッガーによって異なる場合があるため (たとえば "[0]" と "0" )、現在一時停止中の xdebug のフレーム値取得/ 以前の xdebug のパスによる値取得 出力から正確な子の名前を使用します。

  • path トークンは、 RESUME、 STEP_*、 xdebug_run_to_line 、または一時停止位置のその他の変更後に更新します。

次の呼び出し:

パラメーター:

  • sessionId: デバッグセッション ID。 xdebug のデバッガーステータス取得 または xdebug のデバッガーセッション開始 から返された現在の ID を使用します。 セッションが停止、タイムアウト、または消失した場合は、古い ID を再利用する前にセッションリストを更新してください。 フォーマット: デフォルトではセッション名を ID として使用します。同じ名前を共有するセッションが複数ある場合、ID は <sessionName>#<executionId> です。 null で、アクティブなセッションがひとつだけ存在する場合は、自動的に選択されます。 複数のセッションがアクティブで、 sessionId が省略されている場合、呼び出しは失敗します。 デフォルト: null。

  • frameIndex: 整数としてのスタックフレームインデックス (0 = 最上位フレーム)。 現在一時停止中の xdebug のスタック取得 結果から取得します。 RESUME、 STEP_*、 xdebug_run_to_line 、または一時停止位置の変更後は、キャッシュされたフレームインデックスを再利用しないでください。 null の場合、最上位フレームを使用します。 デフォルト: null。

  • path: 移動先をたどる子の名前のリスト。例: ['myObject', 'field', 'subField'] または ['items', '[0]', 'name']。 現在一時停止中の xdebug のフレーム値取得/xdebug のパスによる値取得 出力から正確なノード名を使用し、一時停止位置が変更された後は古いパストークンを更新します。

  • depth: 評価結果の子を展開する最大深さ (0 = 値のみ、1 = 直接の子、2 = 子 + 孫など)。 デフォルト: 0。

  • projectPath: プロジェクトパス。 曖昧な呼び出しを減らすため、この値がわかっている場合は必ずこの値を指定してください。 現在の作業ディレクトリのみがわかっている場合は、それをプロジェクトパスとして使用できます。

xdebug_list_breakpoints

プロジェクト内または特定のファイル内にあるすべてのブレークポイントを一覧表示します。 現在設定されているすべてのブレークポイントとそのプロパティを確認するには、このツールを使用します。

振る舞い:

  • filePath が指定されている場合、そのファイル内のブレークポイントのみを返します。

  • 各ブレークポイントの詳細な属性を返します (id、 type、 ファイル、 line、 有効、 owner、 condition、 isLogMessage、 isLogStack、 temporary、 suspendPolicy、 hitCount)。

次の呼び出し:

  • 適切なブレークポイントが存在しない場合は、 xdebug のブレークポイント設定 を呼び出します。

  • その後、 xdebug_control_session(action=RESUME) と xdebug_control_session(action=WAIT_FOR_PAUSE) で実行を続行します。

パラメーター:

  • filePath: ブレークポイントをフィルターするためのオプションのファイルパス。 ファイルへのパス。 プロジェクト相対パス、 .. を含むパス、絶対パス、 /path/lib.jar!/pkg/Foo.class のようなアーカイブエントリや file:// 、 jar:// 、 jrt:// などの URL に対応しています。 他のツールから返されたパスは、そのまま渡すことができます(例: search_* ツールからのパス)。 指定しない場合、すべてのブレークポイントを返します。 デフォルト: null。

  • projectPath: プロジェクトパス。 曖昧な呼び出しを減らすため、この値がわかっている場合は必ずこの値を指定してください。 現在の作業ディレクトリのみがわかっている場合は、それをプロジェクトパスとして使用できます。

xdebug_remove_breakpoint

オーナーおよび任意のセレクターでフィルタリングされたブレークポイントを削除します。 以前に設定したブレークポイントを削除するには、このツールを使用します。

振る舞い:

  • owner のデフォルトは agent です。

  • owner のみが指定されている場合、その所有者のすべてのブレークポイントを削除します。

  • breakpointId が指定されている場合、選択した所有者の一致するブレークポイント(複数可)を削除します。

  • filePath + line が指定されている場合、選択した所有者の一致する行ブレークポイント(複数可)を削除します。

  • 複数のセレクターが指定されている場合、それらすべてが結合されます (論理 AND)。

  • 冪等: 存在しないブレークポイントを削除すると removed=false が返されます。

  • 所有者に関係なくすべてのブレークポイントを削除するには、二度呼び出します。一度は owner=user 、もう一度は owner=agent を使用します。

次の呼び出し:

パラメーター:

  • breakpointId: xdebug のブレークポイント設定 または xdebug のブレークポイント一覧 から返された正規ブレークポイント ID。

  • filePath: ブレークポイントをフィルターするためのオプションのファイルパス。 ファイルへのパス。 プロジェクト相対パス、 .. を含むパス、絶対パス、 /path/lib.jar!/pkg/Foo.class のようなアーカイブエントリや file:// 、 jar:// 、 jrt:// などの URL に対応しています。 他のツールから返されたパスは、そのまま渡すことができます(例: search_* ツールからのパス)。 指定しない場合、すべてのブレークポイントを返します。 デフォルト: null。

  • line: オプション入力: 削除するブレークポイントの行番号 (1 始まり)。

  • owner: ブレークポイント所有者フィルター。 デフォルト: agent。

  • projectPath: プロジェクトパス。 曖昧な呼び出しを減らすため、この値がわかっている場合は必ずこの値を指定してください。 現在の作業ディレクトリのみがわかっている場合は、それをプロジェクトパスとして使用できます。

xdebug_run_to_line

対象の行まで実行を再開します。 手動でステップせずに特定のソース位置まで実行するには、このツールを使用します。

前提条件:

  • セッションは中断されている必要があります。

  • ターゲットファイル/行は有効である必要があります。

結果:

  • paused: セッションがターゲット位置またはその後で一時停止しました。

  • stopped: 一時停止前にセッションが終了しました。

  • timeout: タイムアウト期間内に一時停止/停止しませんでした。

次の呼び出し:

パラメーター:

  • sessionId: デバッグセッション ID。 xdebug のデバッガーステータス取得 または xdebug のデバッガーセッション開始 から返された現在の ID を使用します。 セッションが停止、タイムアウト、または消失した場合は、古い ID を再利用する前にセッションリストを更新してください。 フォーマット: デフォルトではセッション名を ID として使用します。同じ名前を共有するセッションが複数ある場合、ID は <sessionName>#<executionId> です。 null で、アクティブなセッションがひとつだけ存在する場合は、自動的に選択されます。 複数のセッションがアクティブで、 sessionId が省略されている場合、呼び出しは失敗します。 デフォルト: null。

  • filePath: プロジェクトルートからの相対パス。

  • line: ターゲット行番号 (1 始まり)。

  • timeout: 一時停止/停止結果を待機するミリ秒単位のタイムアウト。 デフォルト: 30000。

  • projectPath: プロジェクトパス。 曖昧な呼び出しを減らすため、この値がわかっている場合は必ずこの値を指定してください。 現在の作業ディレクトリのみがわかっている場合は、それをプロジェクトパスとして使用できます。

xdebug_set_breakpoint

ブレークポイントを作成または更新します。 行ブレークポイントの設定、既存のブレークポイントの ID による更新、トレースポイント/ログ記録動作の制御には、このツールを使用します。

ターゲット指定モード:

  • 位置指定: filePath + line を指定し、 breakpointId を省略します (または null を渡します)。 ""、 "/" 、または "__omit__" などのプレースホルダー文字列は使用しないでください。

  • ID 指定: xdebug のブレークポイント設定 または xdebug のブレークポイント一覧 から返された既存の不透明な正規 breakpointId を指定します (オプションの filePath/line で行ブレークポイントを再配置できます)。

検証:

  • 位置モードでは、 filePath と line の両方が必要です。

  • ID モードでは、ブレークポイントが存在し、 breakpointId によって一意に識別される必要があります。

  • 位置モードでは、 filePath はプロジェクトルートからの相対パス、 line は 1 始まりで、ターゲット位置は実行可能である必要があります。

イベント報告:

  • 無効な condition 式は、 xdebug_control_session(...).breakpointErrorsTail 経由で非同期に報告されます。

  • isLogMessage または isLogStack 、あるいはその両方を持つブレークポイントからのトレースポイント出力は、 xdebug_control_session(action=DRAIN_EVENTS).tracepointOutputsTail 経由でドレインされます。

  • ブレークポイントエラーとトレースポイント出力の報告は、現在 JVM ベースのデバッガー (Java、Kotlin など) でのみサポートされています。

  • xdebug のブレークポイント設定 レスポンスが成功しても、 condition またはトレースポイント式が有効であることは保証されません。それらに依存する前に、後で breakpointErrorsTail を確認してください。

  • 成功した行ブレークポイントレスポンスには、ブレークポイントが現在存在する実際のソース行の切り詰められた抜粋である lineText も含まれます。 再開する前に、検査して配置を確認してください。

適用セマンティクス:

  • 指定されたフィールドは、ターゲットブレークポイントの結果状態として適用されます。

  • condition=null は既存の条件をクリアします。

  • isLogMessage=true はブレークポイントのヒット位置をログに記録します。

  • isLogStack=true は現在のスタックトレースをログに記録します。

  • 両方のフラグが true の場合、位置とスタックの両方がログに記録されます。

  • isLogMessage/isLogStack + suspendPolicy=NONE を指定すると、ブレークポイントはトレースポイントとして動作します。

  • ID モードで、行ブレークポイントに filePath/line が指定されている場合、新しい位置に再配置 (再作成) されます。

  • ID モードでは、行以外のブレークポイントの場合、 filePath/line は無視され、 message で報告されます。

  • 成功した操作はすべて、ブレークポイントを agent 所有 (mcpBreakpointMarker) としてマークします。

次の呼び出し:

  • 返された lineText または xdebug のブレークポイント一覧 、あるいはその両方を使用して配置を確認します。

  • xdebug_start_debugger_session または xdebug_control_session(action=RESUME) 経由で実行を開始/続行します。

パラメーター:

  • breakpointId: xdebug のブレークポイント設定 または xdebug のブレークポイント一覧 から返された正規ブレークポイント ID。

  • filePath: ブレークポイントをフィルターするためのオプションのファイルパス。 ファイルへのパス。 プロジェクト相対パス、 .. を含むパス、絶対パス、 /path/lib.jar!/pkg/Foo.class のようなアーカイブエントリや file:// 、 jar:// 、 jrt:// などの URL に対応しています。 他のツールから返されたパスは、そのまま渡すことができます(例: search_* ツールからのパス)。 指定しない場合、すべてのブレークポイントを返します。 デフォルト: null。

  • line: 1 から始まる行番号。 位置モードでのみ必須です。 ID モードでは、行ブレークポイントを再配置するためにオプションで指定できます。

  • condition: オプションの条件式 - これが true に評価された場合にのみブレークポイントがトリガーされます。 検証エラーは xdebug_control_session(...).breakpointErrorsTail 経由で非同期に報告されます (JVM ベースのデバッガーのみ)。 デフォルト: null。

  • isLogMessage: ブレークポイントに到達したときにブレークポイントのヒット位置 (ソースの場所) をログに記録するかどうか。 JVM ベースのデバッガーでは、出力は xdebug_control_session(action=DRAIN_EVENTS).tracepointOutputsTail から利用できます。 デフォルト: false。

  • isLogStack: ブレークポイントに到達したときにスタックトレースをログに記録するかどうか。 JVM ベースのデバッガーでは、出力は xdebug_control_session(action=DRAIN_EVENTS).tracepointOutputsTail から利用できます。 デフォルト: false。

  • temporary: 一時ブレークポイント (最初のヒット後に削除されます)。 デフォルト: false。

  • suspendPolicy: サスペンドポリシー: ALL、 THREAD、 NONE。 デフォルト: ALL。

  • 有効: ブレークポイントが有効化されているかどうか。 デフォルト: true。

  • projectPath: プロジェクトパス。 曖昧な呼び出しを減らすため、この値がわかっている場合は必ずこの値を指定してください。 現在の作業ディレクトリのみがわかっている場合は、それをプロジェクトパスとして使用できます。

xdebug_set_variable

選択されたスタックフレーム内の変数の値を、パスで指定して書き換えます。 デバッグ中に状態を変更するには、このツールを使用します。

前提条件:

パスフォーマットは xdebug のパスによる値取得 と同じです。 newValue は現在のフレームの言語での生の式である必要があり、デバッガー/評価機能によってターゲット値に代入可能である必要があります。 JSON エスケープされたペイロードや、 \\"text\\" のようなリテラルエスケープシーケンスを渡さないでください。

結果:

  • oldValue/newValue/applied を返します。

  • サポートされていない変更は、テキストメッセージ付きのエラーを返します。

次の呼び出し:

パラメーター:

  • sessionId: デバッグセッション ID。 xdebug のデバッガーステータス取得 または xdebug のデバッガーセッション開始 から返された現在の ID を使用します。 セッションが停止、タイムアウト、または消失した場合は、古い ID を再利用する前にセッションリストを更新してください。 フォーマット: デフォルトではセッション名を ID として使用します。同じ名前を共有するセッションが複数ある場合、ID は <sessionName>#<executionId> です。 null で、アクティブなセッションがひとつだけ存在する場合は、自動的に選択されます。 複数のセッションがアクティブで、 sessionId が省略されている場合、呼び出しは失敗します。 デフォルト: null。

  • frameIndex: 整数としてのスタックフレームインデックス (0 = 最上位フレーム)。 現在一時停止中の xdebug のスタック取得 結果から取得します。 RESUME、 STEP_*、 xdebug_run_to_line 、または一時停止位置の変更後は、キャッシュされたフレームインデックスを再利用しないでください。 null の場合、最上位フレームを使用します。 デフォルト: null。

  • path: ターゲット値へのパス。 xdebug のパスによる値取得 と同じフォーマットです。 現在一時停止中の xdebug のフレーム値取得/xdebug のパスによる値取得 出力から正確なノード名を使用し、一時停止位置が変更された後は古いパストークンを更新します。

  • newValue: 代入する新しい値の式。 現在のフレームの言語で生の式テキストを渡します。デバッガー/評価機能によってターゲット値に代入可能である必要があります。 JSON エスケープされたペイロードや、リテラルのバックスラッシュエスケープされた引用符付きテキストを渡さないでください。

  • projectPath: プロジェクトパス。 曖昧な呼び出しを減らすため、この値がわかっている場合は必ずこの値を指定してください。 現在の作業ディレクトリのみがわかっている場合は、それをプロジェクトパスとして使用できます。

xdebug_start_debugger_session

現在のプロジェクト内で、名前で指定した既存の実行構成、またはコード位置 (filePath + line) のいずれかに対してデバッガーセッションを開始します。 デバッガーセッションを開始するには、このツールを使用します。 このツールは、既存の実行構成名、または filePath + line のいずれかと一緒に使用します。 filePath + line を使用する場合、 main のような実行可能コードであるメソッド、テスト、または別の実行可能なエントリポイントがある行は、ほぼ常に機能します。 どの行を使用すればよいかわからない場合は、 実行構成を取得 がファイル内の実行可能コードの場所の検出に役立ちます。 セッションが開始され、その後ほかのデバッガーツールを使用して実行を制御できます。

前提条件:

  • configurationName を使用する場合は、既存の実行構成名を正確に渡してください。テストメソッド名やその他の派生ターゲット識別子は渡さないでください。

  • filePath + line を使用する場合は、 main 、テスト、または別の実行可能なエントリポイントのような実行可能コードの場所を指定します。

  • まず少なくともひとつのブレークポイントを設定してください。そうしないと、プログラムが一時停止せずに最後まで実行されることがあります。

  • configurationName 、または line と一緒に filePath のいずれかを渡してください。 これらのモードは排他的です。

振る舞い:

  • セッション作成を timeout まで待機します。

  • セッション開始後に猶予待機 (graceWaitMs) を適用し、更新された状態を返します。

  • オプションの起動オーバーライド (programArguments、 workingDirectory、 envs) は、このデバッグ起動にのみ適用され、永続化されません。

  • 実行構成を取得 はオーバーライドサポートの信頼できる情報源です。選択した実行構成が supportsDynamicLaunchOverrides=true を報告する場合にのみ、起動オーバーライドを渡してください。

  • このデバッグ起動用に構成済みの起動値を明示的に変更する必要がある場合を除き、これらのオーバーライドパラメーターを渡さないでください。

  • オーバーライドパラメーターが未指定または null の場合、既存の実行構成値は変更されません。

  • 文字列オーバーライド (programArguments、 workingDirectory) では、未指定/null または空文字列 ("") の場合、既存の値は変更されません。

  • このデバッグ起動で既存の値をクリアするには、 " " のような空白のみの文字列を渡します。

次の呼び出し:

デバッガーセッションのメタデータと、起動からの実行スナップショットフィールドを含むフラットな結果を返します:

  • sessionId、 name、 status 、およびオプションの runConfigurationName

  • output プレビューとオプションの fullOutputPath

  • プロセス終了がすでにわかっている場合のオプションの exitCode

パラメーター:

  • configurationName: デバッグする既存の実行構成の名前。

  • filePath: プロジェクトルートからのファイルパス。 コード位置からデバッグを開始するには、 line と一緒に指定します。

  • line: filePath 用の 1 から始まる行番号。 filePath と一緒に指定し、 configurationName とは組み合わせないでください。

  • timeout: デバッグセッションの開始を待機するミリ秒単位のタイムアウト。 デフォルト: 60000。

  • graceWaitMs: セッション開始後に状態を更新するためのミリ秒単位の猶予待機時間。 デフォルト: 2000。

  • programArguments: この実行時のみプログラム引数のオーバーライド。未指定または null または空文字列なら既存値が維持され、空白文字列の場合はクリアされます。 選択した実行構成が 実行構成を取得 で supportsDynamicLaunchOverrides=true を報告する場合にのみ、これを渡してください。 未指定または null または空文字列なら既存値が維持され、空白のみの場合はクリアされます。

  • workingDirectory: この実行時のみワーキングディレクトリのオーバーライド。未指定または null または空文字列なら既存値が維持され、空白文字列の場合はクリアされます。 選択した実行構成が 実行構成を取得 で supportsDynamicLaunchOverrides=true を報告する場合にのみ、これを渡してください。 未指定または null または空文字列なら既存値が維持され、空白のみの場合はクリアされます。

  • envs: この実行時のみ環境変数のオーバーライド。未指定または null の場合は既存環境変数を変更せず、指定時は既存値にマージされます。 選択した実行構成が 実行構成を取得 で supportsDynamicLaunchOverrides=true を報告する場合にのみ、これを渡してください。 未指定または null の場合は既存環境変数を変更せず、指定された値は既存環境変数にマージされます。

  • projectPath: プロジェクトパス。 曖昧な呼び出しを減らすため、この値がわかっている場合は必ずこの値を指定してください。 現在の作業ディレクトリのみがわかっている場合は、それをプロジェクトパスとして使用できます。

実行ツールセット

実行構成を実行

現在のプロジェクトで命名指定の既存実行構成またはコード位置(filePath + line )から生成した一時実行構成を実行し、指定したタイムアウトまで終了を待ちます。 このツールは、 実行構成を取得 で返された構成の命名、または get_run_configurations(filePath = ...) で返された実行ポイント(filePath + line )いずれかで利用できます。

オプションの起動オーバーライド(programArguments、 workingDirectory、 envs )はこの実行時のみ適用され、保存されません。 この実行時の起動値を変更する必要がある場合を除き、これらのオーバーライドパラメーターは渡さないでください。 オーバーライドパラメーターが未指定または null の場合、既存の実行構成値は変更されません。 文字列オーバーライド(programArguments、 workingDirectory )の場合、missing/null または空の文字列("" )は既存の値を変更しません。 " " のような空白のみの文字列を渡すと、現行値をクリアします。

configurationName 、または line と一緒に filePath のいずれかを渡してください。 これらのモードは排他的です。

振る舞い:

  • waitForExit=true の場合、プロセス終了まで timeout ミリ秒待機します。 タイムアウトした場合はプロセスがバックグラウンドで実行され続け、 exitCode は結果に含まれません。

  • waitForExit=false の場合、プロセスが開始されるまでのみ待機し、 timeout を適用せずに即時返却します。

  • fullOutputPath は生の出力全体を持つ一時ファイルを指し、プロセスが生存している間は出力が増え続ける可能性があります。

現在の出力スナップショット、任意の終了コード、および任意の fullOutputPath を含む実行結果を返します。

パラメーター:

  • configurationName: 実行する既存実行構成の命名。

  • filePath: プロジェクトルートからのファイルパス。 line と一緒に指定すると、コード文脈から一時実行構成を作成・実行します。

  • line: filePath 用の 1 から始まる行番号。 filePath と一緒に指定し、 configurationName とは組み合わせないでください。

  • timeout: タイムアウト(ミリ秒)。

  • waitForExit: プロセス終了を待機するかどうか。 If false, the tool returns immediately after the process starts and ignores timeout.

  • programArguments: この実行時のみプログラム引数のオーバーライド。未指定または null または空文字列なら既存値が維持され、空白文字列の場合はクリアされます。 未指定または null または空文字列なら既存値が維持され、空白のみの場合はクリアされます。

  • workingDirectory: この実行時のみワーキングディレクトリのオーバーライド。未指定または null または空文字列なら既存値が維持され、空白文字列の場合はクリアされます。 未指定または null または空文字列なら既存値が維持され、空白のみの場合はクリアされます。

  • envs: この実行時のみ環境変数のオーバーライド。未指定または null の場合は既存環境変数を変更せず、指定時は既存値にマージされます。 未指定または null の場合は既存環境変数を変更せず、指定された値は既存環境変数にマージされます。

  • projectPath: プロジェクトパス。 曖昧な呼び出しを減らすため、この値がわかっている場合は必ずこの値を指定してください。 現在の作業ディレクトリのみがわかっている場合は、それをプロジェクトパスとして使用できます。

実行構成を取得

入力に応じて、プロジェクトの実行構成または実行可能ファイルのコード位置を返します。

filePath が無い場合、このツールはプロジェクトの既存実行構成を一覧表示します。 結果には構成の命名や、利用可能な場合はプログラム引数・ワーキングディレクトリ・環境変数・ supportsDynamicLaunchOverrides などの起動情報が含まれます。

supportsDynamicLaunchOverrides は、 実行構成を実行 および xdebug デバッガー セッションを開始 におけるワンタイム起動オーバーライド(programArguments、 workingDirectory、 envs )のソース・オブ・トゥルース機能フラグです。 このフラグが選択中構成で true の場合のみ、それらのオーバーライドパラメーターを渡してください。

filePath を指定すると、そのファイル内の実行可能ファイルのエントリポイント(テストメソッド・メインメソッドや IDE が実行ガターアイコンを表示するその他の実行エントリポイント)を検出します。 結果には filePath と runPoints が含まれます。返された行番号は 実行構成を実行 で実行に利用できます。

パラメーター:

  • filePath: プロジェクトルートからのオプションのファイルパス。 指定すると、プロジェクト全体の実行構成ではなくファイル内の実行ポイント(実行可能ファイルのエントリポイント)を返します。

  • projectPath: プロジェクトパス。 曖昧な呼び出しを減らすため、この値がわかっている場合は必ずこの値を指定してください。 現在の作業ディレクトリのみがわかっている場合は、それをプロジェクトパスとして使用できます。

ファイルツールセット

新しいファイルを作成

プロジェクトディレクトリ内の指定されたパスに新しいファイルを作成します。 オプションで、指定されたテキストをファイルに書き込みます。

パラメーター:

  • pathInProject: プロジェクトルートを基準としてファイルを作成するパス。

  • text (オプション): 新しいファイルに書き込むコンテンツ。

  • overwrite: 既存のファイルを上書きするかどうか。 false に設定すると、競合が発生した場合に例外がスローされます。

  • projectPath: プロジェクトパス。 曖昧な呼び出しを減らすため、この値がわかっている場合は必ずこの値を指定してください。 現在の作業ディレクトリのみがわかっている場合は、それをプロジェクトパスとして使用できます。

開いているすべてのファイルパスを取得

アクティブなエディターまたは他の開いているエディターで編集用に開かれたすべてのファイルのパスを、プロジェクトルートからの相対パスで返します。 このツールを使用すると、現在開いているエディターを調べることができます。

パラメーター:

  • projectPath: プロジェクトパス。 曖昧な呼び出しを減らすため、この値がわかっている場合は必ずこの値を指定してください。 現在の作業ディレクトリのみがわかっている場合は、それをプロジェクトパスとして使用できます。

ディレクトリツリーを一覧表示

指定されたディレクトリのツリー表示を、 tree ユーティリティに似た疑似グラフィック形式で提供します。 このツールは、ディレクトリまたはプロジェクト全体の内容を調べるのに使用できます。 ディレクトリ一覧の表示には、 ls や dir などのコマンドラインユーティリティよりも、このツールを推奨します。

パラメーター:

  • directoryPath: プロジェクトルートからの相対パス。

  • maxDepth: 最大再帰深度。

  • timeout: タイムアウト(ミリ秒)。

  • projectPath: プロジェクトパス。 曖昧な呼び出しを減らすため、この値がわかっている場合は必ずこの値を指定してください。 現在の作業ディレクトリのみがわかっている場合は、それをプロジェクトパスとして使用できます。

エディターでファイルを開く

指定されたファイルを JetBrains IDE エディターで開きます。 開くファイルへのパスを含む filePath パラメーターが必要です。 ファイルパスは絶対パスまたはプロジェクトルートからの相対パスで指定できます。

パラメーター:

  • filePath: プロジェクトルートからの相対パス。

  • projectPath: プロジェクトパス。 曖昧な呼び出しを減らすため、この値がわかっている場合は必ずこの値を指定してください。 現在の作業ディレクトリのみがわかっている場合は、それをプロジェクトパスとして使用できます。

フォーマットツールセット

ファイルを整形

JetBrains IDE で指定されたファイルを再フォーマットします。 このツールを使用すると、パスで指定されたファイルにコードフォーマットを適用できます。

パラメーター:

  • path: プロジェクトルートからの相対パス。

  • projectPath: プロジェクトパス。 曖昧な呼び出しを減らすため、この値がわかっている場合は必ずこの値を指定してください。 現在の作業ディレクトリのみがわかっている場合は、それをプロジェクトパスとして使用できます。

インスペクションジェネレーター MCP ツール

インスペクション KTS の検証

inspection.kts スクリプトを仕様例に照らして検証します。 インスペクションをコンパイルし、肯定または否定の例に対して実行します。 コンパイルの結果ステータスおよび詳細な検証結果を返します。

肯定例でインスペクションがトリガーされる必要があります(問題が発生する想定)。 否定例ではインスペクションがトリガーされてはいけません(禁止行で問題は検知されない想定)。

全体の成否、各例ごとの結果、集計統計を返します。

パラメーター:

  • inspectionKtsCode: コンパイルおよび検証する inspection.kts スクリプトの内容。

  • pathToSpecification: 検証対象仕様のパス。

  • projectPath: プロジェクトパス。 曖昧な呼び出しを減らすため、この値がわかっている場合は必ずこの値を指定してください。 現在の作業ディレクトリのみがわかっている場合は、それをプロジェクトパスとして使用できます。

インスペクション KTS MCP ツール

インスペクション KTS API の生成

ターゲット言語用のインスペクション KTS API ドキュメントを返します。 inspection.kts ファイル記述時に利用できるクラスや関数を提供します。

パラメーター:

  • language: ターゲット言語: 'Java' または 'Kotlin'。

  • wrapInTags: true の場合、API の内容を <API> および <api.kt> タグで囲みます。

  • projectPath: プロジェクトパス。 曖昧な呼び出しを減らすため、この値がわかっている場合は必ずこの値を指定してください。 現在の作業ディレクトリのみがわかっている場合は、それをプロジェクトパスとして使用できます。

インスペクション KTS サンプルの生成

ターゲット言語でのコード生成の参考となる inspection.kts テンプレート例を返します。 InspectionKts API でインスペクションを書く方法を示す XML 包装例を提供します。

パラメーター:

  • language: ターゲット言語: 'Java' または 'Kotlin'。

  • includeAdditionalExamples: true の場合、テンプレート以外に追加の厳選例も含みます。

  • projectPath: プロジェクトパス。 曖昧な呼び出しを減らすため、この値がわかっている場合は必ずこの値を指定してください。 現在の作業ディレクトリのみがわかっている場合は、それをプロジェクトパスとして使用できます。

PSI ツリーの生成

指定された Java もしくは Kotlin コードから PSI ツリーを生成し、インデント付きテキストとして返します。 このツールを使うと、インスペクション作成時にコードスニペットの PSI 構造が把握できます。 出力では要素の型と階層、および node.children() が必要な場合のヒントが示されます。

パラメーター:

  • code: 解析対象のソースコードスニペット。

  • language: ターゲット言語: 'Java' または 'Kotlin'。

  • projectPath: プロジェクトパス。 曖昧な呼び出しを減らすため、この値がわかっている場合は必ずこの値を指定してください。 現在の作業ディレクトリのみがわかっている場合は、それをプロジェクトパスとして使用できます。

インスペクション KTS の実行

inspection.kts スクリプトをコンパイルし、ターゲットファイルに対して実行します。 コンパイルエラーがあれば返し、インスペクションで検出された問題リストも返します。 開発中に inspection.kts スクリプトのテストにこのツールを使ってください。

パラメーター:

  • inspectionKtsCode: コンパイルおよび実行する inspection.kts スクリプトの内容。

  • contextPath: 解析対象となるターゲットファイルのプロジェクト内の相対パス(例: src/my/package/Example.kt )。

  • targetFileContent: 解析対象のターゲットファイルの内容。 指定がない場合、ファイルはプロジェクト内に存在する必要があります。

  • projectPath: プロジェクトパス。 曖昧な呼び出しを減らすため、この値がわかっている場合は必ずこの値を指定してください。 現在の作業ディレクトリのみがわかっている場合は、それをプロジェクトパスとして使用できます。

パッチツール

apply_patch

Codex apply_patch フォーマットまたは統合 Git diff フォーマットのパッチを適用します。 Add、Delete、Update 操作をサポートし、更新用にオプションの移動先パスを指定できます。 パスはプロジェクトディレクトリ内に収まっている必要があります。

パラメーター:

  • input: apply_patch フォーマットまたは統合 Git diff フォーマットのパッチテキスト。

  • patch: {patch: ...} を送信するクライアントとの互換性のための input のエイリアス。

  • projectPath: プロジェクトパス。 曖昧な呼び出しを減らすため、この値がわかっている場合は必ずこの値を指定してください。 現在の作業ディレクトリのみがわかっている場合は、それをプロジェクトパスとして使用できます。

読み取りツールセット

ファイルの読み込み

プロジェクトディレクトリ、またはプロジェクト依存関係や他のプロジェクトソースルートからファイルを読み取ります。 Jar/Jrt ファイル内のソースや、ディスク上または Jar/Jrt ファイル内の Java クラスファイルをデコンパイルして読み取ることができます。 行番号付き(1始まり)のテキストとして返します。

モード:

  • slice

  • lines

  • line_columns

  • offsets

  • indentation

モード詳細:

  • slice は start_line と max_lines を使用します。

  • lines は start_line/end_line (含む)を使用します。

  • line_columns は start_line/start_column および end_line/end_column を使用します(end は除外、 end_line はデフォルトで start_line です)。

  • offsets は start_offset/end_offset を使用します(end は除外)。

  • indentation は start_line に max_levels/include_* を組み合わせて使用します。

max_lines はすべてのモードで合計出力を制限します。 context_lines は範囲モード(各サイド)に適用されます。

パラメーター:

  • file_path: ファイルへのパス。 プロジェクト相対パス、 '..' を含むパス、絶対パス、 /path/lib.jar!/pkg/Foo .class のようなアーカイブエントリや file:// 、 jar:// 、 jrt:// などの URL に対応しています。 他のツールから返されたパスは、そのまま渡すことができます(例: search_* ツールからのパス)。

  • mode: 読み取りモード: slice、 lines、 line_columns、 offsets 、または indentation。

  • start_line: 1 始まりの読み取り開始行。

  • max_lines: 返す最大行数(スライスではこの行数、全モードで出力上限あり)。

  • end_line: lines/line_columns モードにおける 1 始まりの終了行(lines は含め、 line_columns は含めない)。

  • start_column: line_columns モードにおける 1 始まりの開始列。

  • end_column: 範囲読み取り用の 1 始まりの終了列(除外)。

  • start_offset: オフセットモード用の 0 始まりの開始オフセット(end_offset が必要)。

  • end_offset: オフセットモード用の 0 始まりの終了オフセット(除外)。

  • context_lines: 範囲の前後(各サイド)に含めるコンテキスト行数。

  • max_levels: インデントモード:含める最大インデントレベル(0 = アンカーブロックのみ)。

  • include_siblings: インデントモード:同じインデントレベルの兄弟ブロックも含めます。

  • include_header: インデントモード:アンカー直上のヘッダーコメントやアノテーションも含めます。

  • projectPath: プロジェクトパス。 曖昧な呼び出しを減らすため、この値がわかっている場合は必ずこの値を指定してください。 現在の作業ディレクトリのみがわかっている場合は、それをプロジェクトパスとして使用できます。

リファクタリングツールセット

rename_refactoring

指定されたファイル内のシンボル(変数、関数、クラスなど)の名前を変更します。 このツールを使用して、名前変更リファクタリング操作を実行します。

単純なテキスト検索と置換とは異なり、 rename_refactoring ツールはコード構造を理解するコンテキスト対応ユーティリティです。 プロジェクト全体にわたって指定されたシンボルへの参照をすべてインテリジェントに更新することで、コードの整合性を確保し、参照の破損を防ぎます。 プログラム上のシンボルの名前変更には、常に推奨されるメソッドです。

ツールは、名前変更操作が成功した場合は成功メッセージを返し、ファイルまたはシンボルが見つからない場合や名前変更操作が失敗した場合はエラーメッセージを返します。

パラメーター:

  • pathInProject: プロジェクトルートからの相対パス。

  • symbolName: リネームするシンボルの命名。

  • newName: シンボルの新しい命名。

  • projectPath: プロジェクトパス。 曖昧な呼び出しを減らすため、この値がわかっている場合は必ずこの値を指定してください。 現在の作業ディレクトリのみがわかっている場合は、それをプロジェクトパスとして使用できます。

ツールを検索

ファイルの検索

プロジェクト内でグロブパターンによりファイルを検索します。 グロブ構文でファイルパスを一致させたいときにこのツールを使います。

グロブパターンはプロジェクトルートからの相対指定です。

例:

  • "**/*.kt"

  • "src/**/Foo*.java"

  • "build.gradle.kts"

'/' のないパターンは "**/pattern" として扱われます。 paths はプロジェクトルート基準のオプション追加グロブフィルターです。

パラメーター:

  • q: 検索する glob パターン。

  • paths: 結果をフィルターするための、プロジェクト相対のグロブパターンリスト。 ! 除外がサポートされています。 末尾の / は ** に展開されます。 / のないパターンは **/pattern として扱われます。 空文字列は無視されます。

  • includeExcluded: 除外・無視されたファイルも結果に含めるかどうか。

  • limit: 返す結果の最大数。

  • projectPath: プロジェクトパス。 曖昧な呼び出しを減らすため、この値がわかっている場合は必ずこの値を指定してください。 現在の作業ディレクトリのみがわかっている場合は、それをプロジェクトパスとして使用できます。

正規表現の検索

プロジェクトファイル内で正規表現に一致するものを検索します。 スニペット付きで正規表現検索したい場合、このツールを使います。 取得できる場合、一致座標(1 始まりの行/列、0 始まりのオフセット)が結果に含まれます。

パスはプロジェクトルート基準のグロブパターンです。

例:

  • ["src/**", "!**/test/**"]

  • ["**/*.kt"]

  • ["foo/"]

パラメーター:

  • q: 検索する正規表現パターン。

  • paths: 結果をフィルターするための、プロジェクト相対のグロブパターンリスト。 ! 除外がサポートされています。 末尾の / は ** に展開されます。 / のないパターンは **/pattern として扱われます。 空文字列は無視されます。

  • limit: 返す結果の最大数。

  • projectPath: プロジェクトパス。 曖昧な呼び出しを減らすため、この値がわかっている場合は必ずこの値を指定してください。 現在の作業ディレクトリのみがわかっている場合は、それをプロジェクトパスとして使用できます。

シンボルの検索

シンボル(クラス、メソッド、フィールド)を検索します。 識別子の一部で意味検索したい場合はこのツールを使います。 取得できる場合、一致座標(1 始まりの行/列、0 始まりのオフセット)が結果に含まれます。

パスはプロジェクトルート基準のグロブパターンです。

デフォルトではプロジェクトのシンボルのみを検索します。 適切な結果が見つからない場合は、 include_external=true で SDK やライブラリのシンボルも検索してみてください。

パラメーター:

  • q: シンボル検索クエリのテキスト。

  • paths: 結果をフィルターするための、プロジェクト相対のグロブパターンリスト。 ! 除外がサポートされています。 末尾の / は ** に展開されます。 / のないパターンは **/pattern として扱われます。 空文字列は無視されます。

  • include_external: SDK およびライブラリシンボルも含めるかどうか。 デフォルトでは無効です。適切な結果が見つからない場合は include_external=true でもう一度試してください。

  • limit: 返す結果の最大数。

  • projectPath: プロジェクトパス。 曖昧な呼び出しを減らすため、この値がわかっている場合は必ずこの値を指定してください。 現在の作業ディレクトリのみがわかっている場合は、それをプロジェクトパスとして使用できます。

テキストの検索

プロジェクトファイル内でテキスト部分文字列を検索します。 スニペット付きの高速テキスト検索用にこのツールを使います。 取得できる場合、一致座標(1 始まりの行/列、0 始まりのオフセット)が結果に含まれます。

パスはプロジェクトルート基準のグロブパターンです。

例:

  • ["src/**", "!**/test/**"]

  • ["**/*.kt"]

  • ["foo/"]

パラメーター:

  • q: 検索するテキスト。

  • paths: 結果をフィルターするための、プロジェクト相対のグロブパターンリスト。 ! 除外がサポートされています。 末尾の / は ** に展開されます。 / のないパターンは **/pattern として扱われます。 空文字列は無視されます。

  • limit: 返す結果の最大数。

  • projectPath: プロジェクトパス。 曖昧な呼び出しを減らすため、この値がわかっている場合は必ずこの値を指定してください。 現在の作業ディレクトリのみがわかっている場合は、それをプロジェクトパスとして使用できます。

スキル検索ツール

明示的なモードで統合プロジェクト検索を実行します:

  • ファイル: glob パス検索。

  • text: リテラルコンテンツ検索。

  • regex: 正規表現コンテンツ検索。

  • symbol: セマンティックシンボル検索。

シンボル検索はデフォルトでプロジェクトが対象です。 適切なシンボルが見つからない場合は、 include_external=true を指定して SDK とライブラリのシンボルも検索してみてください。

パラメーター:

  • mode (必須): 検索モード: ファイル、 text、 regex 、または symbol。

  • q (必須): 検索クエリ。 mode=file の場合、これは glob パターンです。

  • paths: オプションのプロジェクト相対 glob フィルター。 !-excludes と末尾の / をサポートします。

  • include_external: mode=symbol に SDK とライブラリのシンボルを含めるかどうか。 デフォルトでは無効です。適切なものが見つからない場合は、 include_external=true でもう一度試してください。

  • includeExcluded: 除外または無視されたファイルを含めるかどうか。 mode=file でのみサポートされます。

  • limit: 返す結果の最大数。

  • projectPath: プロジェクトパス。 曖昧な呼び出しを減らすため、この値がわかっている場合は必ずこの値を指定してください。 現在の作業ディレクトリのみがわかっている場合は、それをプロジェクトパスとして使用できます。

ターミナルツールセット

ターミナルコマンドを実行

IDE の統合ターミナルで指定されたシェルコマンドを実行します。 このツールを使用すると、IDE 環境内でターミナルコマンドを実行できます。

重要な機能と制限事項:

  • 出力を収集する前にプロセスが実行中かどうかを確認します。

  • 出力を 2000 行に制限します (超過分は切り捨てられます)。

  • 指定されたタイムアウト後に通知とともにタイムアウトします。

  • 設定で ブレイブモードが有効になっていない限り、ユーザーの確認が必要です。

可能な応答を返します:

  • ターミナル出力 (2000 行を超える場合は切り捨てられます)。

  • コマンドがタイムアウトした場合に中断通知を出力します。

  • さまざまな失敗ケースのエラーメッセージ。

パラメーター:

  • command: 実行するシェルコマンド。

  • executeInShell: コマンドをユーザーのデフォルトシェル(bash、zsh など)で実行するかどうかを指定します。 コマンドがシェルスクリプトの場合、またはユーザーのターミナルの実際の環境を維持することが重要な場合に便利です。 false に設定すると、コマンドはプロセスとして起動されます。

  • reuseExistingTerminalWindow: 複数のターミナルを作成しないように、既存のターミナルウィンドウを再利用するかどうか。

  • timeout: タイムアウト(ミリ秒)。

  • maxLinesCount: 返される行の最大数。

  • truncateMode: テキストを切り捨てる方法: 先頭から、途中から、最後から、まったく切り捨てない。

  • projectPath: プロジェクトパス。 曖昧な呼び出しを減らすため、この値がわかっている場合は必ずこの値を指定してください。 現在の作業ディレクトリのみがわかっている場合は、それをプロジェクトパスとして使用できます。

ユニバーサルツール

execute_tool

コマンドライン文字列から特定の IDE MCP ツールを動的に呼び出す汎用ツール実行機能。

パラメーター:

  • command (必須): ツール名と引数を含むコマンドライン文字列。

  • projectPath: プロジェクトパス。 曖昧な呼び出しを減らすため、この値がわかっている場合は必ずこの値を指定してください。 現在の作業ディレクトリのみがわかっている場合は、それをプロジェクトパスとして使用できます。

VCS ツールセット

リポジトリを取得

プロジェクト内の VCS ルートのリストを取得します。 このツールを使用すると、マルチリポジトリプロジェクト内のすべてのリポジトリを識別できます。

パラメーター:

  • projectPath: プロジェクトパス。 曖昧な呼び出しを減らすため、この値がわかっている場合は必ずこの値を指定してください。 現在の作業ディレクトリのみがわかっている場合は、それをプロジェクトパスとして使用できます。

Git ステータス

現在のプロジェクト内の単数または複数のリポジトリの Git ステータスを取得します。 porcelain スタイルのインデックスとワークツリーのステータスコード、およびサマリーカウンターを返します。 デフォルトでは、すべての Git リポジトリが返されます。

パラメーター:

  • repositoryPathRelativeToProject: 単一の包含リポジトリを選択するために使用される、プロジェクトルートからの相対パス (省略可能)。

  • includeUntracked: 追跡対象外のファイルを含めるかどうか。

  • includeIgnored: 無視されたファイルを含めるかどうか。

  • limit: リポジトリごとに返されるエントリの最大数。

  • projectPath: プロジェクトパス。 曖昧な呼び出しを減らすため、この値がわかっている場合は必ずこの値を指定してください。 現在の作業ディレクトリのみがわかっている場合は、それをプロジェクトパスとして使用できます。

2026 年 11 月 6 日