idea-mcp

IntelliJ IDEA MCP スキル

パスのルール（最もよくあるエラーの原因）

パラメーター	パスの種類	例
projectPath	絶対パス	/Users/huangli/dt/dongting
filePath、pathInProject、directoryPath、contextPath	相対パス	server/src/main/java/...

ここを間違えると、「ファイルが見つかりません」エラーの主な原因になります。

注意点とヒント

2 種類の検索 API

IDEA MCP には、異なる形式の結果を返す 2 つの検索ツール群があります。用途に合ったものを選んでください。

• search_in_files_by_text / search_in_files_by_regex — ||ハイライト|| マーカー付きで一致した行を返します。「この文字列がどこで使われているか」を手早く調べるのに適しています。fileMask フィルターに対応しています。
• search_text / search_regex / search_file / search_symbol — 正確な位置（行、列、バイトオフセット）を含む構造化された結果を返します。paths の glob フィルターと ! による除外に対応しています。後続の操作で正確な位置が必要な場合に使用してください。
  • 特に強力なのが search_symbol です。クラス、メソッド、フィールドなどのシンボルを意味的に検索し、コード全体を返します。

execute_terminal_command はデフォルトではシェルを使用しません

executeInShell: true を指定しないと、$() の展開、パイプ、ワイルドカードなどのシェル機能は動作しません。ほとんどのシェルコマンドでは、Bash ツールを直接使用することをおすすめします。

rename_refactoring に渡すのは位置ではなくシンボル名です

パラメーターは symbolName（正確な識別子文字列）と newName であり、ファイルパスと行／列ではありません。これは LSP ベースの名前変更とは異なります。

単一ファイルのコンパイルには build_project を使用

filesToRebuild パラメーターを指定した build_project は、mvn compile を実行するよりも特定のファイルをはるかに高速にコンパイルできます。編集後の簡単な検証に便利です。

get_file_problems と LSP 診断の比較

複数モジュールの Maven プロジェクトでは、get_file_problems は LSP の lsp_diagnostics よりも大幅に正確です。Java のエラーチェックにはこちらをおすすめします。

リスクの高い操作

• rename_refactoring と replace_text_in_file — コードを広範囲に変更するため、使用後に get_file_problems で確認してください
• reformat_file — 確認なしで書式を変更します

トラブルシューティング

問題	解決方法
接続が拒否される	IDEA が MCP プラグインとともに実行されていることを確認してください
リクエストがタイムアウトする	IDEA で権限確認ダイアログを承認してください
ファイルが見つからない	絶対パスと相対パスを確認してください（上記の「パスのルール」を参照）