MCP サーバー
バージョン 2025.2 以降、CLion には統合された MCP サーバー が付属しており、Claude Code、Codex、VS Code などの外部クライアントから IDE が提供するツールにアクセスできます。 これにより、ユーザーは好みのアプリケーションを離れることなく JetBrains IDE を制御し、操作できるようになります。
MCP サーバープラグインを有効化する
この機能は、MCP サーバープラグインに依存しており、CLion にはデフォルトで同梱され有効化されています。 関連機能が利用できない場合は、プラグインを無効化していないことを確認してください。
Ctrl+Alt+S を押して設定を開き、 を選択します。
MCP サーバー プラグインを見つけて、 有効化 をクリックします。
MCP サーバー有効化
MCP サーバーを有効化するには、次の手順に従います。
に進みます。
MCP サーバー有効化 チェックボックスを選択します。
MCP サーバーを有効化しますか? ダイアログで、サードパーティアプリケーションが IDE で開かれたプロジェクトに対してどのアクセス権を取得するかを確認し、 有効化 をクリックして続行します。
変更を適用 をクリックします。
MCP サーバーが有効化されたら、外部クライアントの構成に進めます。
外部クライアントのセットアップ
検出された Junie、 VS Code、 Claude Code、 Codex、 Air、 GitHub Copilot CLI などの外部クライアントでは、構成を自動的に実行できます。 クライアントの設定とは、IDE MCP サーバーのアドレスをそのクライアントの構成ファイルに追加することです。
これを行うには、次の手順を実行します。
に進みます。
クライアントの自動構成 セクションで、MCP サーバーで使用するために設定したい各クライアントの 自動構成 をクリックします。 これにより、クライアントの構成ファイルが自動的に更新されます。 設定済みトランスポートのセットはクライアントによって異なります。

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

構成を有効にするにはクライアントを再起動してください。
プロジェクトレベルのクライアント設定ル 3},{
一部のクライアントは、プロジェクトの作業ディレクトリから構成ファイルも読み取ります。 これらのクライアントでは、IDE が現在開いているプロジェクト内の構成ファイルに接続設定を直接書き込むことができるため、MCP サーバーはそのプロジェクトで作業している間だけ使用できます。
複数のプロジェクトを扱っていて、各クライアントセッションに MCP サーバーを登録したくない場合は、このオプションを使用します。
に進みます。
プロジェクトクライアントの自動構成 セクションで、設定する各クライアントの 自動構成 をクリックします。 これにより、クライアントのプロジェクトレベル構成ファイルが自動的に更新されます。

特定のトランスポートメカニズムを構成する場合は、 自動構成 の横にある
をクリックし、リストから必要なオプションを選択します。
構成を有効にするにはクライアントを再起動してください。
手動クライアントセットアップ
接続したいクライアントがリストにない場合は、手動で構成します。
手動クライアント構成 セクションで、接続タイプに応じて SSE 設定をコピー、 標準入出力設定をコピーする 、または HTTP ストリーム構成のコピー をクリックします。

コピーした構成をクライアントの設定または構成ファイルに貼り付けます。
構成を有効にするにはクライアントを再起動してください。
確認なしでアクションを実行する
MCP サーバーを使用すると、接続された外部クライアントは、毎回ユーザーに確認を求めることなく、ターミナルコマンドを実行したり、IDE で構成を実行したりできます。
このモードを有効にするには:
に進みます。
コマンド実行 セクションで、 確認なしでシェルコマンドまたは実行構成を実行する (勇敢なモード) 設定を有効にします。
変更を適用 をクリックします。
ターミナルセッションでセットアップ候補を表示する
Codex または Claude が一致する MCP サーバーセットアップなしでターミナルセッションで起動した場合、IDE は接続の構成を提案するバナーを表示できます。
この動作を制御するには、次の手順に従います。
に進みます。
ターミナルセッション セクションで、 Codex および Claude ターミナルセッション向けセットアップの提案を表示する チェックボックスを選択または選択解除します。
変更を適用 をクリックします。
サポートされているツール
MCP サーバーは、外部クライアントが IDE やプロジェクトとやりとりできる一連のツールを公開しています。例えば、コードの解析、ファイルの変更、実行構成の実行、またはターミナルコマンドの実行などが可能です。
で利用可能なツールの一覧を閲覧・管理できます。 各ツールについて、 有効化 チェックボックスを選択または選択解除して、そのツールを外部クライアントに公開するかどうかを制御します。

ツールの ルーター専用 チェックボックスを選択することもできます。 ルーター専用ツールは直接の 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を再利用しないでください。
次の呼び出し:
RESUME の後、
xdebug_control_session(action=WAIT_FOR_PAUSE)を呼び出します。一時停止結果の後、
xdebug のスタック取得/xdebug のフレーム値取得/xdebug の式評価を呼び出します。
結果内のステータス値:
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\\"などのリテラルエスケープシーケンスは渡さないでください。
次の呼び出し:
式で仮説が確認された場合は、
xdebug_control_session(STEP_*|RESUME)で続行します。さらに詳細が必要な場合は、
xdebug のフレーム値取得/xdebug のパスによる値取得経由で関連する値を検査します。
パラメーター:
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ファイルlineisCurrentpresentation
ファイルはデバッガーから提供されたとおりに報告されます (パスの正規化なし)。次の呼び出し:
xdebug のフレーム値取得、xdebug のパスによる値取得、またはxdebug の式評価の現在一時停止中の結果からフレームインデックスを使用します。キャッシュされた
frameIndexは、 RESUME、 STEP_*、xdebug_run_to_line、または一時停止位置の変更後に再利用しないでください。
パラメーター:
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
デバッグセッション内のスレッドの一覧を返します。 すべてのスレッドとその現在のステータスを確認するには、このツールを使用します。
前提条件:
セッションは中断されている必要があります。
次の呼び出し:
選択したスレッドには
xdebug のスタック取得を使用します。
ページネーション:
offset/limitは、すべてのスタックを収集した後に適用されます。
順序:
アクティブなスレッドが先頭。
残りのスレッドは、スタック深度の降順で並べ替えられます。
スキーマフィールドには次が含まれます:
idnamestateisCurrentadditionalInfoadditionalInfoTooltipframeCount
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、または一時停止位置のその他の変更後に更新します。
次の呼び出し:
さらに深く掘り下げるには、別の
xdebug のパスによる値取得呼び出しを使用します。直接の名前パスナビゲーションでは不十分な場合は、
xdebug の式評価を使用します。
パラメーター:
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を使用します。
次の呼び出し:
残りのセットを確認するには、
xdebug のブレークポイント一覧を使用します。
パラメーター:
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: タイムアウト期間内に一時停止/停止しませんでした。
次の呼び出し:
一時停止した場合は、
xdebug のスタック取得/xdebug のフレーム値取得/xdebug の式評価を呼び出します。セッションが停止または消失した場合は、別のセッションスコープの呼び出しを発行する前に、
xdebug のデバッガーステータス取得経由でsessionIdを更新します。
パラメーター:
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
選択されたスタックフレーム内の変数の値を、パスで指定して書き換えます。 デバッグ中に状態を変更するには、このツールを使用します。
前提条件:
セッションは中断されている必要があります。
値は変更可能である必要があります。
pathは、現在一時停止中のxdebug のフレーム値取得/xdebug のパスによる値取得出力から取得する必要があります。
パスフォーマットは
xdebug のパスによる値取得と同じです。newValueは現在のフレームの言語での生の式である必要があり、デバッガー/評価機能によってターゲット値に代入可能である必要があります。 JSON エスケープされたペイロードや、\\"text\\"のようなリテラルエスケープシーケンスを渡さないでください。結果:
oldValue/newValue/appliedを返します。サポートされていない変更は、テキストメッセージ付きのエラーを返します。
次の呼び出し:
確認するには、
xdebug のパスによる値取得またはxdebug のフレーム値取得で値を再読み込みします。
パラメーター:
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 または空文字列 ("") の場合、既存の値は変更されません。このデバッグ起動で既存の値をクリアするには、
" "のような空白のみの文字列を渡します。
次の呼び出し:
xdebug_control_session(action=WAIT_FOR_PAUSE)で最初のサスペンドを待機します。一時停止後、ランタイムの証拠として
xdebug のスタック取得とxdebug のフレーム値取得(またはxdebug の式評価) を呼び出します。
デバッガーセッションのメタデータと、起動からの実行スナップショットフィールドを含むフラットな結果を返します:
sessionId、name、status、およびオプションのrunConfigurationNameoutputプレビューとオプションの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 ignorestimeout.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始まり)のテキストとして返します。
モード:
slicelinesline_columnsoffsetsindentation
モード詳細:
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: プロジェクトパス。 曖昧な呼び出しを減らすため、この値がわかっている場合は必ずこの値を指定してください。 現在の作業ディレクトリのみがわかっている場合は、それをプロジェクトパスとして使用できます。