MCP サーバー

分析ツールセット

ビルドプロジェクト

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

編集後にこのツールを使用して、その編集が有効かどうか検証してください。

パラメーター:

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

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

• タイムアウト: タイムアウト（ミリ秒）。

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

ファイルの問題を取得する

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

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

パラメーター:

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

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

• タイムアウト: タイムアウト（ミリ秒）。

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

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

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

パラメーター:

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

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

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

パラメーター:

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

コードインサイトツールセット

シンボル情報を取得する

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

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

パラメーター:

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

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

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

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

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

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

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

特定のスキーマ内にあるデータベースオブジェクト（カラム、型、キー、インデックスなど）の構造を階層化されたテキスト表現として取得します。

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

パラメーター:

• connectionId: 固有の接続 ID。

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

• schemaName: スキーマ名。

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

• objectName ：指定された種類のオブジェクトの命名（例：テーブルやビューの名前）。 空白にできません。

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

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

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

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

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

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

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

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

パラメーター:

• id: 固有の接続 ID。

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

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

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

パラメーター:

• connectionId: 固有の接続 ID。

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

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

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

パラメーター:

• connectionId: 固有の接続 ID。

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

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

パラメーター:

• connectionId: 固有の接続 ID。

• schemaName: スキーマ名。

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

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

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

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

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

各クエリの戻り値:

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

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

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

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

• クエリのテキスト。

パラメーター:

• connectionId: 固有の接続 ID。

SQL クエリをキャンセルする。

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

パラメーター:

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

SQL クエリを実行する。

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

このツールは実行ステータス（成功またはエラー）を報告します。 エラー時には、エラーの説明も提供します。

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

パラメーター:

• connectionId: 固有の接続 ID。

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

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

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

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

パラメーター:

• connectionId: 固有の接続 ID。

• schemaName: スキーマ名。

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

• tableName: テーブル名。

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

開発者キット MCP ツール

ロック要件の使用箇所を検索

キャレット下のメソッドに対する Read/Write ロックの使用状況を解析します。 呼び出しパスもある程度の深さまで解析します。 このツールを使って Read/Write ロック要件の可能な使用箇所を特定します。 ロック要件とそれへの呼び出しパスのリストを返します。

パラメーター:

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

• line ：カーソルがある行。

• column ：カーソルがある列。

• タイムアウト: タイムアウト（ミリ秒）。

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

スレッド要件の使用箇所を検索

キャレット下のメソッドに対し、スレッド制約（例：UI スレッドまたはバックグラウンドスレッドで実行する必要があるかどうか）の使用状況を解析します。 呼び出しパスもある程度の深さまで解析します。 このツールを使ってスレッド要件の可能な使用箇所を特定します。 スレッド要件とそれへの呼び出しパスのリストを返します。

パラメーター:

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

• line ：カーソルがある行。

• column ：カーソルがある列。

• タイムアウト: タイムアウト（ミリ秒）。

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

実行ツールセット

実行_run_構成を実行する。

現在のプロジェクトで、命名により既存の実行構成を実行するか、コード位置（filePath + line ）から作成された一時的な実行構成を実行し、指定したタイムアウトまでその完了を待ちます。 このツールは get_実行_configurations で返された構成名、または get_run_configurations(filePath = ...) で返された実行ポイント（filePath + line ）のいずれかで使用します。

オプションの起動時オーバーライド（programArguments、 workingDirectory、 envs ）はこの実行時のみ適用され、永続化されません。 この実行の構成起動値を明示的に変更する必要がない限り、これらのオーバーライドパラメーターは渡さないでください。 オーバーライドパラメーターが指定されていないまたは null の場合は、既存の実行構成の値が変更されずに保持されます。 文字列オーバーライド（programArguments、 workingDirectory ）では、missing/null または空文字列（"" ）の場合、既存の値は変更されません。 " " のような空白のみの文字列を渡すと、この起動の既存の値がクリアされます。

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

振る舞い：

• waitForExit=true の場合、プロセス終了まで最大 タイムアウト ミリ秒待機します。 タイムアウトが発生した場合、プロセスはバックグラウンドで実行し続け、 exitCode は結果から省略されます。

• waitForExit=false の場合、プロセス開始のみ待機し、 タイムアウト を反映せず即座に返します。

• fullOutputPath は生の出力すべてを持つ一時ファイルを指し、プロセスが生存している間は成長し続ける場合があります。

実行結果には、現在の出力スナップショット、任意の終了コード、およびオプションの fullOutputPath が含まれます。

パラメーター:

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

• filePath ：プロジェクトルートからのファイル相対パス。 line と一緒に指定して、コードコンテキストから一時的な実行構成を作成および実行します。

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

• タイムアウト: タイムアウト（ミリ秒）。

• waitForExit ：プロセスの終了を待つかどうか。 false の場合、プロセス開始後すぐにツールは返され、 タイムアウト は無視されます。

• programArguments ：この起動時のみのプログラム引数のオーバーライド（オプション）。 missing/null または空文字列の場合は既存の値を保持します。空白のみの文字列は既存値をクリアします。

• workingDirectory ：この起動時のみの作業ディレクトリオーバーライド（オプション）。 missing/null または空文字列の場合は既存の値を保持します。空白のみの文字列は既存値をクリアします。

• envs ：この起動時のみの環境変数オーバーライド（オプション）。 missing/null の場合は既存の環境は変更されません。指定された場合は値が既存の環境へマージされます。

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

実行構成を取得する。

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

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

supportsDynamicLaunchOverrides は、 実行_構成を実行 および xdebug_start_debugger_session におけるワンタイム起動オーバーライド（programArguments、 workingDirectory、 envs ）のソース・オブ・トゥルース機能フラグです。 このフラグが選択した構成で true の場合のみ、それらのオーバーライドパラメーターを渡してください。

filePath を指定すると、このツールはそのファイル内の実行可能ファイルのエントリポイント（テストメソッド、main メソッド、または IDE 上で Run ガターアイコンが表示されるその他のエントリポイント）を検出します。 結果には filePath と runPoints が含まれ、返された行番号を 実行_構成を実行 で指定することでコードから実行できます。

パラメーター:

• filePath ：プロジェクトルートからの相対ファイルパス（オプション）。 指定すると、プロジェクト全体の実行構成の代わりにそのファイル内の実行ポイント（実行可能ファイルのエントリポイント）が返されます。

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

ファイルツールセット

新しいファイルを作成する

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

パラメーター:

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

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

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

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

glob でファイルを検索する

プロジェクト内のファイルのうち、相対パスが指定された glob パターンに一致するすべてのファイルを検索します。 検索は、プロジェクトディレクトリのすべてのサブディレクトリ、または指定されたサブディレクトリで再帰的に実行されます。 このツールは、glob パターン（例: **/*.txt ）でファイルを検索する場合に使用します。

パラメーター:

• globPattern: 検索する glob パターン。 パターンはプロジェクトルートからの相対パスで指定する必要があります。 例: src/**/*.java

• subDirectoryRelativePath (オプション): 検索するプロジェクトに相対するサブディレクトリ。

• addExcluded: 除外 / 無視されたファイルを検索結果に追加するかどうか。 ファイルはユーザーまたは無視ルールによって除外できます。

• fileCountLimit: 返されるファイルの最大数。

• タイムアウト: タイムアウト（ミリ秒）。

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

ファイル名キーワードでファイルを検索する

プロジェクト内の、指定したキーワード（大文字と小文字を区別）を含むファイル名を持つすべてのファイルを検索します。 ファイル名の一部がわかっている場合は、このツールを使用してファイルを検索できます。

パラメーター:

• nameKeyword: ファイル名で検索する部分文字列。

• fileCountLimit: 返されるファイルの最大数。

• タイムアウト: タイムアウト（ミリ秒）。

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

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

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

パラメーター:

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

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

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

パラメーター:

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

• maxDepth: 最大再帰深度。

• タイムアウト: タイムアウト（ミリ秒）。

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

モノリポ開発者キット MCP ツール

プロジェクトステータスを取得

プロジェクトがコード解析操作の準備ができているか確認します。 インデックス作成とスキャンのステータスを返します。 lint_files や ファイルの問題を取得 などの重い操作の前に使用して、タイムアウトを防ぎます。

パラメーター:

• 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 ：offsets モードの開始オフセット（0始まり、 end_offset が必要）。

• end_offset ：offsets モードの終了オフセット（0始まり、除外）。

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

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

• include_siblings ：インデントモード：同じインデントレベルの兄弟ブロックを含める。

• include_header ：インデントモード：アンカーの直上にあるヘッダーコメント/アノテーションを含める。

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

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

リネームリファクタリング

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

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

リネームが成功するとツールは成功メッセージを返し、ファイルやシンボルが見つからない場合やリネームに失敗した場合はエラーメッセージを返します。

パラメーター:

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

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

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

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

ノートブック実行ツールセット

ノートブックセルを実行

Jupyter ノートブックでセルの一部またはすべてを実行します。

例：

• {"file_path": "/abs/path/demo.ipynb", "cell_id": "13c5cec416369e19"}

• {"file_path": "/abs/path/demo.ipynb"}

パラメーター:

• file_path： .ipynb ノートブックへの絶対パス。

• cell_id ：省略可能な Jupyter セル ID。 省略時はすべてのセルが実行されます。

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

ターミナルツールセット

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

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

重要な機能と制限事項:

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

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

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

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

可能な応答を返します:

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

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

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

パラメーター:

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

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

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

• タイムアウト: タイムアウト（ミリ秒）。

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

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

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

テキストツールセット

パスからファイルのテキストを取得する

プロジェクトルートからの相対パスを使用して、ファイルのテキストコンテンツを取得します。 ファイルのプロジェクト相対パスがわかっている場合は、このツールを使用してファイルの内容を読み取ることができます。

パラメーター:

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

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

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

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

ファイル内のテキストを置換する

ファイル内のテキストを、検索と置換の柔軟なオプションを使って置換します。 このツールを使用すると、ファイル全体を置換することなく、特定の変更を加えることができます。 置換するテキストが正確にわかっている場合、ファイルの変更に最も効率的なツールです。

次のいずれかの応答を返します。

• ok – 交換は成功しました。

• project dir not found – プロジェクトディレクトリを特定できません。

• file not found – 指定されたファイルが存在しません。

• could not get document – ファイルの内容にアクセスできません。

• no occurrences found – 置換するテキストがファイル内に見つかりませんでした。

パラメーター:

• pathInProject: プロジェクトルートを基準としたターゲットファイルへのパス。

• oldText: 置換するテキスト。

• newText: 置換テキスト。

• replaceAll: すべての出現箇所を置き換えるかどうか。

• caseSensitive: 検索で大文字と小文字を区別するかどうか。

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

正規表現でファイル内検索する

IntelliJ の検索エンジンを使用して、プロジェクト内のすべてのファイル内で正規表現パターンを検索します。 コマンドラインツールでファイルを読み取るよりも、このツールの方がはるかに高速なので、推奨されます。

結果内の出現箇所は、 || 文字で囲まれています。 例： some text ||substring|| text。

パラメーター:

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

• directoryToSearch: プロジェクトルートからの相対的な検索ディレクトリ。 指定しない場合は、プロジェクト全体を検索します。

• fileMask: 検索するファイルマスク。 指定しない場合は、すべてのファイルを検索します。 例: *.java

• caseSensitive: 検索で大文字と小文字を区別するかどうか。

• maxUsageCount: 返されるエントリの最大数。

• タイムアウト: タイムアウト（ミリ秒）。

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

テキストでファイル内検索する

IntelliJ の検索エンジンを使用して、プロジェクト内のすべてのファイル内のテキスト部分文字列を検索します。 コマンドラインツールでファイルを読み取るよりも、このツールの方がはるかに高速なので、推奨されます。

結果内の出現箇所は、 || 文字で囲まれています。 例: some text ||substring|| text

パラメーター:

• searchText: 検索するテキストの部分文字列。

• directoryToSearch: プロジェクトルートからの相対的な検索ディレクトリ。 指定しない場合は、プロジェクト全体を検索します。

• fileMask: 検索するファイルマスク。 指定しない場合は、すべてのファイルを検索します。 例: *.java

• caseSensitive: 検索で大文字と小文字を区別するかどうか。

• maxUsageCount: 返されるエントリの最大数。

• タイムアウト: タイムアウト（ミリ秒）。

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

VCS ツールセット

リポジトリを取得する

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

パラメーター:

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

Rails 専用ツール

rails のルートを取得する。

プロジェクト内の Rails ルートを取得します。 結果はページ区切りのリストで返され、包含 / 除外パス、アクション（完全修飾名（FQN）で指定）、ディレクトリ、HTTP メソッドに基づいてフィルタリングされます。

このツールは Rails ルートの詳細な分析を実行するため、手動コードインスペクションよりも優先されます。

パラメーター:

• ページ: ページ付けのためのページ番号。

• page_size: ページあたりの項目数。

• included_route_path_filters: 含めるルートパスパターンのリスト。

• excluded_route_path_filters: 除外するルートパスパターンのリスト。

• included_action_fqn_filters: 含める完全修飾アクション名のリスト。

• excluded_action_fqn_filters: 除外する完全修飾アクション名のリスト。

• included_action_directory_filters: 含めるアクションディレクトリのリスト。

• excluded_action_directory_filters: 除外するアクションディレクトリのリスト。

• min_action_count: ルートに必要なアクションの最小数。

• max_action_count: ルートが持つことができるアクションの最大数。

• included_http_method_filters: 含める HTTP メソッドのリスト (GET、POST など)。

• excluded_http_method_filters: 除外する HTTP メソッドのリスト。

rails のモデルを取得する。

プロジェクト内の Rails モデルを取得します。 結果はページ分けされ、FQN でフィルタリングできます。

パラメーター:

• ページ: ページ付けのためのページ番号。

• page_size: ページあたりの項目数。

• included_fqn_filters: 含める FQN パターンのリスト。

• excluded_fqn_filters: 除外する FQN パターンのリスト。

• included_directory_filters: 含めるディレクトリのリスト。

• excluded_directory_filters: 除外するディレクトリのリスト。

• controller_filter: 対応するコントローラーを持つモデルと持たないモデルのみを含めるようにフィルターします。

rails のコントローラーを取得する。

プロジェクト内の Rails コントローラーを取得します。 結果はページ分けされ、FQN、ディレクトリ、ビュー、抽象ステータス、対応するモデルの有無でフィルタリングできます。

パラメーター:

• ページ: ページ付けのためのページ番号。

• page_size: ページあたりの項目数。

• included_fqn_filters: 含める FQN パターンのリスト。

• excluded_fqn_filters: 除外する FQN パターンのリスト。

• included_directory_filters: 含めるディレクトリのリスト。

• excluded_directory_filters: 除外するディレクトリのリスト。

• included_view_filters: 含めるビューフィルターのリスト。

• excluded_view_filters: 除外するビューフィルターのリスト。

• abstract_filter: 抽象コントローラー、非抽象コントローラー、すべてのコントローラーのみを含めるようにフィルターします。

• model_filter: 対応するモデルを持つ、または持たないコントローラーのみを含めるようにフィルターします。

rails のコード編集ヘルパーを取得する。

プロジェクト内の Rails ヘルパーを取得します。 結果はページ分けされ、FQN とディレクトリでフィルタリングできます。

パラメーター:

• ページ: ページ付けのためのページ番号。

• page_size: ページあたりの項目数。

• included_fqn_filters: 含める FQN パターンのリスト。

• excluded_fqn_filters: 除外する FQN パターンのリスト。

• included_directory_filters: 含めるディレクトリのリスト。

• excluded_directory_filters: 除外するディレクトリのリスト。

rails のビューを取得する。

プロジェクト内の Rails ビューを取得します。 結果はページ分けされ、パーシャリティ、レイアウト、コントローラーの関連付け、パス、コントローラーディレクトリ /FQN でフィルタリングできます。

パラメーター:

• ページ: ページ付けのためのページ番号。

• page_size: ページあたりの項目数。

• partiality_filter: 部分ビューのみ、非部分ビューのみ、その両方を含めるようにフィルターします。

• layout_filter: レイアウトビューのみ、非レイアウトビューのみ、またはその両方を含めるようにフィルターします。

• controller_filter: 関連するコントローラーを持つビューのみを含めるようにフィルターします。

• included_path_filters: 含めるビューパスのリスト。

• excluded_path_filters: 除外するビューパスのリスト。

• included_controller_fqn_filters: 含めるコントローラー FQN のリスト。

• excluded_controller_fqn_filters: 除外するコントローラー FQN のリスト。

• included_controller_directory_filters: 含めるコントローラーディレクトリのリスト。

• excluded_controller_directory_filters: 除外するコントローラーディレクトリのリスト。

rails のメイラーを取得する。

プロジェクト内の Rails メーラーを取得します。 結果はページ分けされ、FQN とディレクトリでフィルタリングできます。

パラメーター:

• ページ: ページ付けのためのページ番号。

• page_size: ページあたりの項目数。

• included_fqn_filters: 含める FQN パターンのリスト。

• excluded_fqn_filters: 除外する FQN パターンのリスト。

• included_directory_filters: 含めるディレクトリのリスト。

• excluded_directory_filters: 除外するディレクトリのリスト。