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

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

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

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

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

ツールの ルーター専用 チェックボックスをオンにすることもできます。 ルーター専用ツールは直接の MCP ツールリストから非表示になり、専用ルーター ツールを通じてのみ利用できます。 これにより、不要なツールの説明がツールリストに表示されず、コンテキストを節約できます。 以下のツールに対してルーター専用モードを有効化 設定を使用して、ルーター専用モードを適用するタイミングを指定します。たとえば、 すべてのエージェント や ACP エージェントのみ に対して指定できます。
以下は、MCP サーバーによって提供されるツールのリストです。
解析ツールすべて
- 呼び出しを分析
メソッド、関数、コンストラクター、またはサポートされている型に対応した IDE の呼び出し階層ツリーを構築します。 シンボルを呼び出す側 (
INCOMING_CALLS) またはシンボルが呼び出す対象 (OUTGOING_CALLS) を確認するために使用します。実際の呼び出しに基づいて依存関係を評価する場合は、使用箇所検索、テキスト検索、正規表現検索よりもこのツールを優先してください。 IDE の呼び出し階層データを使用するため、単純な検索よりもノイズが少なく、追加の呼び出し回数も少ない、より正確な呼び出し関係を提供します。
symbolFqnを完全修飾名として渡します。例:com.example.Service.run。 名前があいまいな場合、ツールは正確なシグネチャーを返します。そのいずれかをsymbolFqnとして渡し直します。 短い名前または断片しか分からない場合は、まずsearch_symbolを使用してターゲットを見つけます。結果は展開可能なテキストツリーです。 各ノードには
filePathとtreePathが含まれます。filePathは可能な場合、プロジェクト相対になります。 サブツリーをレンダリングするには、treePathを渡し直します。childOffsetを使用して、切り詰められた … ほか n 件 行の後に続行します。depth、maxChildren、maxNodesは、レンダリングされるツリーの範囲を制限します。 IDE が解決できる場合、シンボルはプロジェクトソース、ソース JAR、または逆コンパイルされたバイナリ JAR 依存関係から取得できます。パラメーター:
symbolFqn(必須): プレーンな完全修飾シンボル名、またはあいまいさエラーによって返された、あるいはレンダリングされた子ノードからコピーされた正確なシグネチャー。 短い名前または断片しか分からない場合は、まずsearch_symbolを使用し、最適な完全修飾呼び出し可能名をここに渡します。 例: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: サブツリールートへの任意のパス。以前の呼び出しを分析結果から正確にコピーします。 Null または省略は、ルートパス[]を意味します。 各コンポーネントは表示名ではなく、正確なシグネチャーです。childOffset:treePathで指定されたノードの直接の子をページングするためのオフセット。 デフォルトは 0 です。タイムアウト: タイムアウト(ミリ秒)。projectPath: プロジェクトパス。 曖昧な呼び出しを減らすため、この値がわかっている場合は必ずこの値を指定してください。 現在の作業ディレクトリのみがわかっている場合は、それをプロジェクトパスとして使用できます。
- ビルドプロジェクト
プロジェクトや指定ファイルのビルドをトリガーし、補完が終わるまで待機してビルドエラーを返します。 このツールを使ってプロジェクトをビルドまたはファイルをコンパイルし、コンパイルエラーや警告の詳細情報を取得できます。
編集を行った後に、その編集が有効かどうかを検証するためにこのツールを使用する必要があります。
パラメーター:
rebuild: プロジェクトを完全に再ビルドするかどうか。 デフォルトは false です。filesToRebuildが指定されていない場合のみ有効です。filesToRebuild: 指定した場合は、指定パスのファイルだけをコンパイルします。 パスはプロジェクトルートからの相対パスです。タイムアウト: タイムアウト(ミリ秒)。projectPath: プロジェクトパス。 曖昧な呼び出しを減らすため、この値がわかっている場合は必ずこの値を指定してください。 現在の作業ディレクトリのみがわかっている場合は、それをプロジェクトパスとして使用できます。
- ファイルの問題を取得
IntelliJ インスペクションを使用して、指定されたファイルのエラーと警告を分析します。 このツールを使用すると、特定のファイル内のコーディングの問題、構文エラー、その他の問題を特定できます。
重大度、説明、場所の情報を含む問題のリストを返します。
パラメーター:
filePath: プロジェクトルートからの相対パス。errorsOnly: エラーのみを含めるか、エラーと警告の両方を含めるか。タイムアウト: タイムアウト(ミリ秒)。projectPath: プロジェクトパス。 曖昧な呼び出しを減らすため、この値がわかっている場合は必ずこの値を指定してください。 現在の作業ディレクトリのみがわかっている場合は、それをプロジェクトパスとして使用できます。
- プロジェクトの依存関係を取得
プロジェクトで定義されているすべての依存関係のリストを返します。 ライブラリ名に関する構造化された情報を提供します。
パラメーター:
projectPath: プロジェクトパス。 曖昧な呼び出しを減らすため、この値がわかっている場合は必ずこの値を指定してください。 現在の作業ディレクトリのみがわかっている場合は、それをプロジェクトパスとして使用できます。
- プロジェクトモジュールを取得
プロジェクト内のすべてのモジュールとそのタイプをリスト形式で返します。 各モジュールの名前やタイプなど、構造化された情報を提供します。
パラメーター:
projectPath: プロジェクトパス。 曖昧な呼び出しを減らすため、この値がわかっている場合は必ずこの値を指定してください。 現在の作業ディレクトリのみがわかっている場合は、それをプロジェクトパスとして使用できます。
- lint_files
IntelliJ インスペクションを使用して、指定されたファイルのエラーと警告を分析します。 編集後に複数のファイルを lint するには、このツールを使用します。 ファイルごとの問題を、重大度、説明、場所情報とともに返します。
バッチレスポンスには、個々のファイルが利用可能な予算を超えた場合に、
timedOut: trueと空のproblemsを含むファイルエントリが含まれることがあります。notAnalyzedReasonを含むファイルエントリは、分析できなかったファイルを示します。たとえば、プロジェクトコンテンツルート外のファイル、除外されたファイル、またはサポートされていないファイルタイプです。 トップレベルのmore: trueは、バッチが不完全であることを意味します。パラメーター:
files(必須): 分析するプロジェクト相対ファイルのリスト。 重複するパスは正規化後に無視されます。min_severity: 含める最小重大度:warningまたはerror。 デフォルトはwarningです。タイムアウト: タイムアウト(ミリ秒)。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。
実行ツール
- 実行構成を実行
既存の実行構成を命名指定で実行、またはコード位置(
filePath+line)から作成された一時実行構成を現在のプロジェクトで実行し、指定されたタイムアウトまで終了を待ちます。 このツールはget_実行_configurationsで返される構成名、またはget_run_configurations(filePath = ...)で返される実行ポイント(filePath+line)と組み合わせて使用します。オプションの起動オーバーライド(
programArguments、workingDirectory、envs)はこの実行のみに適用され、永続化されません。 この実行の起動値を明示的に変更する必要がない限り、これらのオーバーライドパラメーターは渡さないでください。 オーバーライドパラメーターが未指定または null の場合、既存の実行構成値は変更されません。 文字列オーバーライド(programArguments、workingDirectory)の場合、未指定・null または空文字列("")の場合は現在の値が維持されます。" "のような空白のみの文字列を渡すと、既存の値をクリアできます。configurationName、またはfilePathとlineの両方のいずれかを渡します。 これらのモードは同時に利用できません。動作:
waitForExit=trueの場合、プロセス終了まで最大タイムアウトミリ秒待機します。 タイムアウトした場合はプロセスがバックグラウンドで実行され、exitCodeは結果に含まれません。waitForExit=falseの場合はプロセスの開始のみを待ち、タイムアウトの適用なしですぐに返します。fullOutputPathはフルの生出力を持つ一時ファイルを指し、プロセスが動作している間は内容が増え続けます。
現在の出力スナップショット、オプションの終了コード、およびオプションの
fullOutputPathを含む実行結果を返します。パラメーター:
configurationName: 実行する既存の実行構成の名前。filePath: プロジェクトルートからの相対ファイルパス。lineと組み合わせて指定すると、コードコンテキストから一時的な実行構成を作成・実行します。line:filePath用の 1 始まりの行番号。filePathと一緒に指定し、configurationNameとは組み合わせないでください。タイムアウト: タイムアウト(ミリ秒)。waitForExit: プロセス終了まで待機するかどうか。 false の場合、プロセス開始と同時にツールは即座に返り、タイムアウトは無視されます。programArguments: この起動のみのプログラム引数オーバーライド。 未指定・null または空文字列の場合は既存値が維持され、空白のみの文字列の場合はクリアされます。workingDirectory: この起動のみの作業ディレクトリオーバーライド。 未指定・null または空文字列の場合は既存値が維持され、空白のみの文字列の場合はクリアされます。envs: この起動のみの環境変数オーバーライド。 未指定/null の場合は既存の環境変数が維持され、指定時は値が既存環境にマージされます。projectPath: プロジェクトパス。 曖昧な呼び出しを減らすため、この値がわかっている場合は必ずこの値を指定してください。 現在の作業ディレクトリのみがわかっている場合は、それをプロジェクトパスとして使用できます。
- 実行構成を取得
入力に応じて、プロジェクトの実行構成または実行可能ファイルのコード位置のいずれかを返します。
filePathなしの場合、このツールはプロジェクトの既存実行構成を一覧表示します。 結果には構成名と、利用可能な場合は起動詳細(プログラム引数・作業ディレクトリ・環境変数・supportsDynamicLaunchOverridesなど)が含まれます。supportsDynamicLaunchOverridesは、execute_実行_構成およびxdebug_デバッガー_start_debugger_sessionにおけるワンタイム起動オーバーライド(programArguments、workingDirectory、envs)の信頼できる能力フラグです。 このフラグが選択された構成でtrueの場合のみ、それらのオーバーライドパラメーターを渡してください。filePathが指定されている場合、このツールはそのファイル内の実行可能エントリポイント(テストメソッド、main メソッド、または IDE が実行ガターアイコンを表示する他のエントリポイント)を検出します。 結果にはfilePathとrunPointsが含まれ、execute_実行_構成で返された行番号とともにコードから実行できます。パラメーター:
filePath: プロジェクトルートからの相対ファイルパス(任意)。 指定時はプロジェクト全体の実行構成ではなく、そのファイル内の実行ポイント(実行可能エントリポイント)を返します。projectPath: プロジェクトパス。 曖昧な呼び出しを減らすため、この値がわかっている場合は必ずこの値を指定してください。 現在の作業ディレクトリのみがわかっている場合は、それをプロジェクトパスとして使用できます。
ファイルツール
- 新規ファイルを作成
プロジェクトディレクトリ内の指定されたパスに新しいファイルを作成します。 オプションで、指定されたテキストをファイルに書き込みます。
パラメーター:
pathInProject: プロジェクトルートを基準としてファイルを作成するパス。text(オプション): 新しいファイルに書き込むコンテンツ。overwrite: 既存のファイルを上書きするかどうか。falseに設定すると、競合が発生した場合に例外がスローされます。projectPath: プロジェクトパス。 曖昧な呼び出しを減らすため、この値がわかっている場合は必ずこの値を指定してください。 現在の作業ディレクトリのみがわかっている場合は、それをプロジェクトパスとして使用できます。
- 開いているすべてのファイルパスを取得
アクティブなエディターまたは他の開いているエディターで編集用に開かれたすべてのファイルのパスを、プロジェクトルートからの相対パスで返します。 このツールを使用すると、現在開いているエディターを調べることができます。
パラメーター:
projectPath: プロジェクトパス。 曖昧な呼び出しを減らすため、この値がわかっている場合は必ずこの値を指定してください。 現在の作業ディレクトリのみがわかっている場合は、それをプロジェクトパスとして使用できます。
- ディレクトリツリーを一覧表示
指定されたディレクトリのツリー表示を、
treeユーティリティに似た疑似グラフィック形式で提供します。 このツールは、ディレクトリまたはプロジェクト全体の内容を調べるのに使用できます。 ディレクトリ一覧の表示には、lsやdirなどのコマンドラインユーティリティよりも、このツールを推奨します。パラメーター:
directoryPath: プロジェクトルートからの相対パス。maxDepth: 最大再帰深度。タイムアウト: タイムアウト(ミリ秒)。projectPath: プロジェクトパス。 曖昧な呼び出しを減らすため、この値がわかっている場合は必ずこの値を指定してください。 現在の作業ディレクトリのみがわかっている場合は、それをプロジェクトパスとして使用できます。
- エディターでファイルを開く
指定されたファイルを JetBrains IDE のエディターで開きます。 開くファイルへのパスを含む
filePathパラメーターが必要です。 ファイルパスは絶対パスまたはプロジェクトルートからの相対パスで指定できます。パラメーター:
filePath: プロジェクトルートからの相対パス。projectPath: プロジェクトパス。 曖昧な呼び出しを減らすため、この値がわかっている場合は必ずこの値を指定してください。 現在の作業ディレクトリのみがわかっている場合は、それをプロジェクトパスとして使用できます。
フォーマットツール
- ファイルを整形
JetBrains IDE で指定されたファイルを再フォーマットします。 このツールを使用すると、パスで指定されたファイルにコードフォーマットを適用できます。
パラメーター:
path: プロジェクトルートからの相対パス。projectPath: プロジェクトパス。 曖昧な呼び出しを減らすため、この値がわかっている場合は必ずこの値を指定してください。 現在の作業ディレクトリのみがわかっている場合は、それをプロジェクトパスとして使用できます。
IDE アクションツール
- invoke_ide_action
アクション ID で IDE アクションを呼び出します。 これを使うとプログラムから任意の IDE アクション(例:ツールウィンドウの表示や設定の切り替えなど)をトリガーできます。
選択されたファイル、フォルダー、モジュールを必要とするアクションが正しく動作するよう、
filePathsでファイル/フォルダーコンテキストをオプションで指定できます(例:MarkExcludeRoot、ReformatCode、NewFile)。パラメーター:
actionId: 呼び出すアクション ID(例:ActivateTerminalToolWindow、TogglePresentationMode)。filePaths: アクションの文脈として指定するファイル/フォルダーパス(プロジェクトルート相対、任意)。
- IDE アクション検索
テキストクエリで IDE アクションを検索します。
invoke_ide_actionの呼び出し前に利用可能なアクションを確認できます。パラメーター:
query: アクション ID、命名、説明から検索するテキスト(大文字小文字を区別しない部分文字列一致)。limit: 返される結果の最大数(デフォルト:50)。includeGroups: 結果にアクショングループを含めるかどうか(デフォルト:false)。
インスペクションジェネレーター MCP ツール
- インスペクション KTS 検証
インスペクション.kts スクリプトを仕様例に対して検証します。 インスペクションをコンパイルし、正例・負例に対して実行します。 コンパイルステータスおよび詳細な検証結果が返されます。
正例ではインスペクションがトリガーされるはずです(問題が発生することが期待されます)。 負例ではインスペクションがトリガーされてはいけません(禁止行で問題が発生しないことが期待されます)。
全体の成功、各例ごとの結果、および集計統計を返します。
パラメーター:
inspectionKtsCode: コンパイルと検証を行う インスペクション.kts スクリプトの内容。pathToSpecification: 検証対象の例を含む仕様へのパス。projectPath: プロジェクトパス。 曖昧な呼び出しを減らすため、この値がわかっている場合は必ずこの値を指定してください。 現在の作業ディレクトリのみがわかっている場合は、それをプロジェクトパスとして使用できます。
インスペクション KTS MCP ツール
- インスペクション KTS API 生成
ターゲット言語に対応したインスペクション KTS API のドキュメントを返します。 インスペクション.kts ファイルを記述する際に利用できるクラスや関数を提供します。
パラメーター:
language: ターゲット言語:'Java' または 'Kotlin'。wrapInTags: true の場合、API の内容を<API>および<api.kt>タグでラップします。projectPath: プロジェクトパス。 曖昧な呼び出しを減らすため、この値がわかっている場合は必ずこの値を指定してください。 現在の作業ディレクトリのみがわかっている場合は、それをプロジェクトパスとして使用できます。
- インスペクション KTS 例生成
コード生成のガイドとなるターゲット言語用の インスペクション.kts テンプレート例を返します。 InspectionKts API を使ったインスペクションの書き方を示す XML でラップされた例を提供します。
パラメーター:
language: ターゲット言語:'Java' または 'Kotlin'。includeAdditionalExamples: true の場合、テンプレート以外にもキュレーションされた追加例を含めます。projectPath: プロジェクトパス。 曖昧な呼び出しを減らすため、この値がわかっている場合は必ずこの値を指定してください。 現在の作業ディレクトリのみがわかっている場合は、それをプロジェクトパスとして使用できます。
- PSI ツリー生成
提供された Java または Kotlin コードから PSI ツリーを作成し、インデント付きのテキストとして返します。 このツールを使い、インスペクション作成時にコードスニペットの PSI 構造を理解します。 出力には要素タイプとその階層、および
node.children()の必要なタイミングに関するヒントが表示されます。パラメーター:
code: 解析するソースコードスニペット。language: ターゲット言語:'Java' または 'Kotlin'。projectPath: プロジェクトパス。 曖昧な呼び出しを減らすため、この値がわかっている場合は必ずこの値を指定してください。 現在の作業ディレクトリのみがわかっている場合は、それをプロジェクトパスとして使用できます。
- インスペクション KTS 実行
インスペクション.kts スクリプトをコンパイルしてターゲットファイルに実行します。 コンパイルエラーやインスペクションで検出された問題のリストを返します。 開発中に インスペクション.kts スクリプトのテストにこのツールを使用します。
パラメーター:
inspectionKtsCode: コンパイルと実行を行う インスペクション.kts スクリプトの内容。contextPath: 解析するターゲットファイルのプロジェクト内相対パス(例: src/my/パッケージ/Example.kt )。targetFileContent: 解析するターゲットファイルの内容。 指定しない場合、ファイルはプロジェクト内に存在する必要があります。projectPath: プロジェクトパス。 曖昧な呼び出しを減らすため、この値がわかっている場合は必ずこの値を指定してください。 現在の作業ディレクトリのみがわかっている場合は、それをプロジェクトパスとして使用できます。
インスペクションツール
- get_inspections
IDE のインスペクションを使ってファイルを解析します。 重要度、説明、場所、利用可能なクイックフィックスと共に問題を返します。 ファイル編集後にコードの検証を行うため、このツールを使用します。
各問題には、
apply_quick_fixを使用して適用できるクイックフィックスが含まれます。パラメーター:
filePath: プロジェクトルートからの相対パス。minSeverity: 最低重要度レベル:ERROR、WARNING、WEAK_WARNING、INFORMATION。 デフォルト:WEAK_WARNING。タイムアウト: タイムアウト(ミリ秒)。
- apply_quick_fix
インスペクション問題の解決のためにクイックフィックスを適用します。
quickFix情報をget_inspections結果から取得し、どの修正を適用するか特定してください。 このツールは、指定された場所でハイライト処理を再度実行し、一致する修正を適用します。パラメーター:
filePath: プロジェクトルートからの相対パス。line: 問題が存在する 1 始まりの行番号。column: 問題が存在する 1 始まりの列番号。quickFixName: 適用するクイックフィックスの名前(quickFixes[].nameをget_inspections結果から)。
PHP デバッガーツール
- xdebug_single_file
単一 PHP スクリプトの Xdebug セッションを開始します。
パラメーター:
path: デバッグ対象 PHP スクリプトへの絶対パス。
- xdebug_start_server
PHP の組み込み dev サーバーと Xdebug リスナーを起動します。 これを呼び出した後、
xdebug_set_breakpointでブレークポイントを設定し、xdebug_requestで特定の URL のデバッグを行います。パラメーター:
projectRoot: PHP プロジェクトのルートディレクトリへの絶対パス。host: dev サーバーがバインドするホスト(デフォルト:localhost)。port: dev サーバーのポート(デフォルト:8081)。
- xdebug_request
dev サーバーに HTTP リクエストを送り、デバッグを開始します。 デバッグ接続を自動的に確立し、全ブレークポイントを適用します。 デバッガーの状態を返します。ブレークポイントで停止した場合、セッションは一時停止し、
xdebug_stack、xdebug_contextで検査できます。またxdebug_step_over/xdebug_step_intoでステップ実行もできます。 ブレークポイントで停止しなかった場合、スクリプトは補完まで実行されます。パラメーター:
url: リクエストする完全な URL 例:http://127.0.0.1:8081/add?a=3&b=5。
- xdebug_stop_server
PHP の dev サーバーと XDebug リスナーを停止します。 デバッグをすべて終えた際に使用します。
パラメーター: なし。
- xdebug_set_breakpoint
行ブレークポイントを設定します。 デバッグセッションの前または途中で呼び出せます。 ブレークポイントはリクエストをまたいで保持され、新しい
xdebug_requestのたびに自動で再適用されます。パラメーター:
line: ブレークポイントを設定する行番号。file: ファイルパス(絶対またはプロジェクトルートからの相対パス)。 シングルスクリプトモードでは省略可能です。
- xdebug_run
次のブレークポイントまたはスクリプト終了まで実行を継続します。 ブレークポイントで停止した場合、セッションが一時停止し、検査やステップ実行が可能です。 スクリプトが終了した場合、セッションは終了します。
パラメーター: なし。
- xdebug_step_into
次の関数呼び出しへステップインします。 呼び出し先関数の最初の行でセッションが一時停止します。
xdebug_stackおよびxdebug_contextで検査できます。パラメーター: なし。
- xdebug_step_over
現在の行を実行し、同じスコープ内の次の行で一時停止します。
xdebug_stackおよびxdebug_contextで検査できます。パラメーター: なし。
- xdebug_step_out
現在の関数がリターンするまで実行し、呼び出し元で一時停止します。
xdebug_stackおよびxdebug_contextで検査できます。パラメーター: なし。
- xdebug_stack
現在のコールスタックをファイルパスと行番号付きで返します。 ブレークポイントで一時停止している場合のみ利用可能です。
パラメーター: なし。
- xdebug_context
指定したスタック深度にあるスコープ内のすべての変数を返します(デフォルト:
0= 現在のフレーム)。 ローカル変数とスーパーグローバルが含まれます。 ブレークポイントで一時停止している場合のみ利用可能です。パラメーター:
stackDepth: 検査するスタック深度(デフォルト:0= 現在のフレーム)。
- xdebug_status
現在のデバッガーセッションの状態(
starting、running、break、stopping)を返します。パラメーター: なし。
- xdebug_pause
現在の地点で実行を一時停止します。 スクリプトが実行中で場所を調べたいときに使用します。
パラメーター: なし。
- xdebug_eval
現在のスコープで PHP 式を評価し、その結果を返します。 ブレークポイントで一時停止している場合のみ利用可能です。 例:
$user->getName()、count($items)、$a + $b。パラメーター:
expression: 評価する PHP 式。
- xdebug_property_get
特定の変数を命名で指定し、その値を返します。
$obj->fieldや$arr[0]のようなネストしたプロパティに対応します。 ブレークポイントで一時停止している場合のみ利用可能です。パラメーター:
name: 変数名(例:$myVar、$this->field)。stackDepth: 検査するスタック深度(デフォルト:0= 現在のフレーム)。
- xdebug_property_set
現在のスコープ内で変数の値を変更します。 ブレークポイントで一時停止している場合のみ利用可能です。
パラメーター:
name: 変数名(例:$myVar)。value: PHP のリテラルで指定する新しい値(例:42、\"hello\"、true)。
- xdebug_breakpoint_list
XDebug エンジンで現在設定されている全ブレークポイントを一覧表示します。
パラメーター: なし。
- xdebug_breakpoint_remove
ID でブレークポイントを削除します。 ブレークポイント ID を調べるには
xdebug_breakpoint_listを利用してください。パラメーター:
id: 削除するブレークポイント ID。
- xdebug_detach
デバッグを終了し、PHP スクリプトを通常通り完了させます。 Dev サーバーでデバッグ時にこれを利用すると、HTTP レスポンスが完了し、サーバーが次の
xdebug_requestを受け入れられるようになります。パラメーター: なし。
- xdebug_stop
PHP スクリプトを即座に終了し、デバッグセッションも終了します。
xdebug_single_fileでシングルスクリプトのデバッグ中に使用します。パラメーター: なし。
PHP プロジェクトコンテキストツール
- get_composer_dependencies
プロジェクトにインストールされている全ての Composer パッケージとその正確なバージョンを返します。
既にインデックス化された
composer.lockデータから読み取ります ― ディスク I/O やネットワーク呼び出しはありません。 モノリポ構成では、すべてのcomposer.jsonサブプロジェクトのパッケージも含まれます。コードを生成する前に利用可能なライブラリとバージョンを判定するために使用します。
パラメーター:
nameFilter: パッケージ名でフィルターするグロブパターン(例:"laravel/*"、"*phpunit*"、"symfony/console")。 大/小文字の区別なし。 すべてのパッケージを返す場合、省略してください。
- get_php_project_config
PhpStorm が認識している PHP プロジェクト構成を返します。
含まれる内容: 設定された PHP 言語レベル、インタープリターの詳細(名前、パス、ローカル/リモート)、PHP ランタイム情報(正確なバージョン、読み込まれている拡張機能、
php.iniパス、デバッガー)。このデータは IDE 設定とキャッシュ済みインタープリターメタデータから取得されており、ディスク I/O やネットワーク呼び出しは発生しません。 プロジェクトの PHP 環境を把握し、コードを生成したり解析する前に利用してください。
言語レベルはシステム PHP バージョンと異なる場合があります(例:プロジェクトは 8.1 をターゲット、システムは 8.3 を実行中)。 リモートインタープリター(Docker/SSH)利用時には、PHP 情報を得る唯一の方法です。
パラメーター: なし。
パッチツール
- パッチを適用
Codex
パッチを適用フォーマットまたは統合 Git diff フォーマットでパッチを適用します。 Add、Delete、Update 操作をサポートし、更新には任意の移動先パスを指定できます。 パスはプロジェクトディレクトリ内に収まっている必要があります。パラメーター:
input:パッチを適用フォーマットまたは統合 Git diff フォーマットのパッチテキスト。patch:{patch: ...}を送信するクライアントとの互換性のためのinputのエイリアス。projectPath: プロジェクトパス。 曖昧な呼び出しを減らすため、この値がわかっている場合は必ずこの値を指定してください。 現在の作業ディレクトリのみがわかっている場合は、それをプロジェクトパスとして使用できます。
リードツール
- read_file
プロジェクトディレクトリや依存関係、他のプロジェクトソースルート内のファイルを読み取ります。 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: ファイルへのパス。 プロジェクト相対パス、 「..」 を含むパス、絶対パス、 /パス/lib.jar!/pkg/Foo .class のようなアーカイブエントリ、 ファイル:// 、 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: プロジェクトパス。 曖昧な呼び出しを減らすため、この値がわかっている場合は必ずこの値を指定してください。 現在の作業ディレクトリのみがわかっている場合は、それをプロジェクトパスとして使用できます。
リファクタリングツール
- 名前変更リファクタリング
指定されたファイル内のシンボル (変数、関数、クラスなど) をリネームします。 このツールを使用して、名前変更リファクタリング操作を実行します。
単純なテキスト検索と置換とは異なり、
名前変更リファクタリングツールはコード構造を理解するコンテキスト対応ユーティリティです。 プロジェクト全体にわたって指定されたシンボルへの参照をすべてインテリジェントに更新することで、コードの整合性を確保し、参照の破損を防ぎます。 プログラムシンボルの名前変更には、常にこの方法が推奨されます。ツールは、名前変更操作が成功した場合は成功メッセージを返し、ファイルまたはシンボルが見つからない場合や名前変更操作が失敗した場合はエラーメッセージを返します。
パラメーター:
pathInProject: プロジェクトルートからの相対パス。symbolName: リネームするシンボルの名前。newName: シンボルの新しい名前。projectPath: プロジェクトパス。 曖昧な呼び出しを減らすため、この値がわかっている場合は必ずこの値を指定してください。 現在の作業ディレクトリのみがわかっている場合は、それをプロジェクトパスとして使用できます。
ツールを検索
- search_file
プロジェクト内でグロブパターンによるファイル検索を行います。 グロブ構文でファイルパスを一致させたいときにこのツールを使用してください。
グロブパターンはプロジェクトルートに対して相対的です。
例:
"**/*.kt""src/**/Foo*.java""build.gradle.kts"
'/'を含まないパターンは"**/pattern"として扱われます。pathsはプロジェクトルートを基準にした追加のグロブフィルター(任意)です。パラメーター:
q: 検索する glob パターン。paths: 結果をフィルターするためのプロジェクト相対のグロブパターンのリスト(任意)。!除外をサポートしています。 末尾の/は**に展開されます。/を含まないパターンは**/patternとして扱われます。 空文字列は無視されます。includeExcluded: 除外/無視されたファイルも結果に含めるかどうか。limit: 返す最大件数。projectPath: プロジェクトパス。 曖昧な呼び出しを減らすため、この値がわかっている場合は必ずこの値を指定してください。 現在の作業ディレクトリのみがわかっている場合は、それをプロジェクトパスとして使用できます。
- search_regex
プロジェクトファイル内で正規表現の一致を検索します。 スニペット付きの正規表現検索が必要な場合はこのツールをご利用ください。 利用可能な場合、結果には一致座標(1 始まりの行/列、0 始まりのオフセット)が含まれます。
パスはプロジェクトルートに対するグロブパターンです。
例:
["src/**", "!**/test/**"]["**/*.kt"]["foo/"]
パラメーター:
q: 検索する正規表現パターン。paths: 結果をフィルターするためのプロジェクト相対のグロブパターンのリスト(任意)。!除外をサポートしています。 末尾の/は**に展開されます。/を含まないパターンは**/patternとして扱われます。 空文字列は無視されます。limit: 返す最大件数。projectPath: プロジェクトパス。 曖昧な呼び出しを減らすため、この値がわかっている場合は必ずこの値を指定してください。 現在の作業ディレクトリのみがわかっている場合は、それをプロジェクトパスとして使用できます。
- search_symbol
シンボル(クラス、メソッド、フィールド)を検索します。 識別子の一部からセマンティック検索を行いたい場合にこのツールを使用してください。 利用可能な場合、結果には一致座標(1 始まりの行/列、0 始まりのオフセット)が含まれます。
パスはプロジェクトルートに対するグロブパターンです。
デフォルトではプロジェクト内のシンボルのみを検索します。 適切な結果が見つからない場合は、
include_external=trueで再試行して SDK とライブラリのシンボルも検索してください。パラメーター:
q: シンボルのクエリテキスト。paths: 結果をフィルターするためのプロジェクト相対のグロブパターンのリスト(任意)。!除外をサポートしています。 末尾の/は**に展開されます。/を含まないパターンは**/patternとして扱われます。 空文字列は無視されます。include_external: SDK やライブラリのシンボルも含めるかどうか。 デフォルトは無効です。何も見つからない場合はinclude_external=trueで再試行してください。limit: 返す最大件数。projectPath: プロジェクトパス。 曖昧な呼び出しを減らすため、この値がわかっている場合は必ずこの値を指定してください。 現在の作業ディレクトリのみがわかっている場合は、それをプロジェクトパスとして使用できます。
- search_text
プロジェクトファイル内の部分文字列を検索します。 スニペット付きで高速なテキスト検索を行いたい場合にこのツールをご利用ください。 利用可能な場合、結果には一致座標(1 始まりの行/列、0 始まりのオフセット)が含まれます。
パスはプロジェクトルートに対するグロブパターンです。
例:
["src/**", "!**/test/**"]["**/*.kt"]["foo/"]
パラメーター:
q: 検索したいテキスト。paths: 結果をフィルターするためのプロジェクト相対のグロブパターンのリスト(任意)。!除外をサポートしています。 末尾の/は**に展開されます。/を含まないパターンは**/patternとして扱われます。 空文字列は無視されます。limit: 返す最大件数。projectPath: プロジェクトパス。 曖昧な呼び出しを減らすため、この値がわかっている場合は必ずこの値を指定してください。 現在の作業ディレクトリのみがわかっている場合は、それをプロジェクトパスとして使用できます。
スキル検索ツール
- スキル検索
明示的なモードで統合プロジェクト検索を実行します:
file: glob パス検索。text: リテラルコンテンツ検索。regex: 正規表現コンテンツ検索。symbol: セマンティックシンボル検索。
シンボル検索はデフォルトでプロジェクトに重点を置きます。 適切なシンボルが見つからない場合は、
include_external=trueを使用してもう一度試し、SDK とライブラリのシンボルも検索します。パラメーター:
mode(必須): 検索モード:file、text、regex、またはsymbol。q(必須): 検索クエリ。mode=fileの場合、これは glob パターンです。paths: 任意のプロジェクト相対 glob フィルター。!-excludes と末尾の/をサポートします。include_external:mode=symbolに SDK とライブラリシンボルを含めるかどうか。 デフォルトでは無効です。適切なものが見つからない場合は、include_external=trueを使用してもう一度試してください。includeExcluded: 除外または無視されたファイルを含めるかどうか。mode=fileでのみサポートされています。limit: 返す最大件数。projectPath: プロジェクトパス。 曖昧な呼び出しを減らすため、この値がわかっている場合は必ずこの値を指定してください。 現在の作業ディレクトリのみがわかっている場合は、それをプロジェクトパスとして使用できます。
構造検索ツール
- search_structural
構造化検索(SSR)によるコードパターン検索を行います。 テキスト/正規表現検索とは異なり、SSR はコード構造をセマンティックに理解します。
パターン構文例(PHP)
基本パターン:
$a$->$b$()- 任意のオブジェクトのメソッド呼び出し。new $Class$()- 任意のコンストラクター呼び出し。class $a$ extends $b$ {}- クラス継承。$a$ = $b$- 任意の代入。
パターン内の変数:
$name$はパターン変数を示します(その種類の要素であれば何でも一致します)。$a${2,5}- 回数制約: 2~5 回の出現にマッチ。$a$+- 1回以上の出現。$a$*- 0回以上の出現。
get_structural_patternsを利用すると、説明付きの定義済み PHP パターンを見ることができます。既知の制限
PHP SSR には Java SSR と比べていくつかの制限があります:
一部のクラス修飾子(例:
readonly)は一致しない場合があります。制約付きの複雑なネストパターンは期待通りに動作しない場合があります。
get_structural_patternsを利用すると、確実に動作するパターンを確認できます。
制約
パターン変数への制約は
constraintsパラメーターで追加できます。 制約内の変数名はドル記号なしの名前を使用します(例:"b"は$b$の場合):regex: 変数テキストを正規表現と照合します(例:"^get.*"は "get" で始まるメソッドの場合)。invertRegex: 正規表現マッチの否定(マッチしない場合に一致)。minCount/maxCount: 出現回数の範囲。exprType: 式の型にマッチ(例:"string"、"int"など)。
制約例:
{ "b": {"regex": "^get.*", "minCount": 1, "maxCount": 1} }パラメーター:
pattern: 検索対象の SSR パターン(例:$a$->$b$()ならメソッド呼び出し)。fileType: 検索する言語のファイルタイプ名(例:PHP、Java、Kotlin、Python)。directoryToSearch: プロジェクトルートからの相対的な検索ディレクトリ。 指定しない場合は、プロジェクト全体を検索します。constraints: 変数名(ドル記号なし)から制約オブジェクトへのマップとして記述される変数制約。 例:{"b": {"regex": "^get.*"}}maxResults: 返す最大一致数。 デフォルト:100。タイムアウト: タイムアウト(ミリ秒)。
- get_structural_patterns
定義済み PHP 構造化検索パターンとその説明を一覧表示します。
これらのパターンは、直接使用またはカスタムパターン作成時の参考として利用できる共通の検索テンプレートを提供します。
カテゴリ:
一般: クラス、インターフェース、トレイトの定義と構造。
式: 代入、メソッド呼び出し、フィールドアクセスなど。
疑わしい: 潜在的に問題のあるコードパターン。
パラメーター:
category: カテゴリ『一般』『式』『疑わしい』でパターンをフィルターします。 指定しない場合は、すべてのパターンを返します。
ターミナルツール
- ターミナルコマンドを実行
指定されたシェルコマンドを IDE の内蔵ターミナルで実行します。 このツールを使用すると、IDE 環境内でターミナルコマンドを実行できます。
重要な機能と制限事項:
出力を収集する前にプロセスが実行中かどうかを確認します。
出力を 2000 行に制限します (超過分は切り捨てられます)。
指定されたタイムアウト後に通知とともにタイムアウトします。
設定で ブレイブモードが有効になっていない限り、ユーザーの確認が必要です。
可能な応答を返します:
ターミナル出力 (2000 行を超える場合は切り捨てられます)。
コマンドがタイムアウトした場合に中断通知を出力します。
さまざまな失敗ケースのエラーメッセージ。
パラメーター:
command: 実行するシェルコマンド。executeInShell: コマンドをユーザーのデフォルトシェル(bash、zsh など)で実行するかどうかを指定します。 コマンドがシェルスクリプトの場合、またはユーザーのターミナルの実際の環境を維持することが重要な場合に便利です。falseに設定すると、コマンドはプロセスとして起動されます。reuseExistingTerminalWindow: 複数のターミナルを作成しないように、既存のターミナルウィンドウを再利用するかどうか。タイムアウト: タイムアウト(ミリ秒)。maxLinesCount: 返される行の最大数。truncateMode: テキストを切り捨てる方法: 先頭から、途中から、最後から、まったく切り捨てない。projectPath: プロジェクトパス。 曖昧な呼び出しを減らすため、この値がわかっている場合は必ずこの値を指定してください。 現在の作業ディレクトリのみがわかっている場合は、それをプロジェクトパスとして使用できます。
ユニバーサルツール
- ツールを実行
コマンドライン文字列から特定の IDE MCP ツールを動的に呼び出す汎用ツールエグゼキューターです。
パラメーター:
command(必須): ツール名と引数を含むコマンドライン文字列。projectPath: プロジェクトパス。 曖昧な呼び出しを減らすため、この値がわかっている場合は必ずこの値を指定してください。 現在の作業ディレクトリのみがわかっている場合は、それをプロジェクトパスとして使用できます。
VCS ツール
- リポジトリを取得
プロジェクトに設定されている全 VCS ルートのリストを取得します。 このツールを使用すると、マルチリポジトリプロジェクト内のすべてのリポジトリを識別できます。
パラメーター:
projectPath: プロジェクトパス。 曖昧な呼び出しを減らすため、この値がわかっている場合は必ずこの値を指定してください。 現在の作業ディレクトリのみがわかっている場合は、それをプロジェクトパスとして使用できます。
- Git ステータス
現在のプロジェクト内にあるひとつ以上のリポジトリの Git ステータスを取得します。 porcelain スタイルのインデックスとワークツリーのステータスコード、およびサマリーカウンターを返します。 デフォルトでは、すべての Git リポジトリが返されます。
パラメーター:
repositoryPathRelativeToProject: ひとつの包含リポジトリを選択するために使用する、プロジェクトルートからの省略可能な相対パス。includeUntracked: 追跡対象外のファイルを含めるかどうか。includeIgnored: 無視されたファイルを含めるかどうか。limit: リポジトリごとに返されるエントリの最大数。projectPath: プロジェクトパス。 曖昧な呼び出しを減らすため、この値がわかっている場合は必ずこの値を指定してください。 現在の作業ディレクトリのみがわかっている場合は、それをプロジェクトパスとして使用できます。