hechtcarmel/jetbrains-index-mcp-plugin
A Jetbrains IDE IntelliJ plugin aimed to provide coding agents the ability to leverage intelliJ's indexing of the codebase
IDE Index MCP Server – 概要
JetBrains Index MCP Server は、JetBrains IDE（IntelliJ IDEA、PyCharm、WebStorm、GoLand、RustRover、Android Studio、PhpStorm など）用のプラグインで、IDE 内で Model Context Protocol (MCP) サーバー を起動します。サーバーはローカル HTTP ポート（例：IntelliJ では 127.0.0.1:29170）で待ち受け、IDE 自身のコードインテリジェンスエンジン（AST、シンボルインデックス、リファクタリング、診断、ビルド実行ツール）を JSON ベースの RPC 呼び出しとして公開します。
Claude、Codex、Cursor、Windsurf などの AI コーディングアシスタントは、これらの RPC メソッドを呼び出して、以下を実行できます：
- 定義、参照、階層の特定；
- 安全なリファクタリング（名前変更、移動、再フォーマットなど）の実行；
- ファイルの読み取り、テキスト検索、診断の取得、ビルドやテストのトリガー；
- 複数プロジェクトの管理（スリープ/ウェイク、開く/閉じる）でメモリ使用量を低く保つ。
要するに、このプラグインは IDE の強力で言語認識機能を、AI エージェントが単純な静的解析やファジー検索ツールに頼る代わりに使用できるヘッドレスサービスに変えます。
主な機能（専門用語を控えめに）
| 領域 | プラグインが提供するもの | AI アシスタントにとって重要な理由 |
|---|---|---|
| 多言語サポート | Java/Kotlin、Python、JavaScript/TypeScript、Go、PHP、Rust、Scala、Markdown（および JetBrains がすでにサポートする任意の言語）で動作。 | 同じ MCP エンドポイントで、追加設定なしに多くの言語のクエリに回答できます。 |
| ユニバーサルツール | 参照の検索、定義への移動、ファイル/テキスト検索、診断の読み取り、IDE の仮想ファイルシステムの同期、ビルド/テストのトリガー、プロジェクトの開閉など。 | AI にコードベースの真のセマンティックビューを提供します（単なる生テキストではありません）。 |
| 言語認識リファクタリング | 安全な名前変更、ファイル移動、再フォーマット、インポートの最適化、メンバーの編集/挿入/置換、メソッドシグネチャの変更、Java から Kotlin への変換など。 | AI は参照を壊さずに自動適用される変更を提案できます。 |
| プロジェクトライフサイクル管理 | アイドルプロジェクトは自動的にスリープし、PSI キャッシュが解放され、必要に応じて再オープンされます。 | AI が多くのリポジトリで作業するときにメモリ使用量を適切に保ちます。 |
| ヘッドレス/リモート対応 | サーバーは通常の IDE ウィンドウ、JetBrains リモート開発セッション、またはヘッドレス自動化実行で動作します。 | ローカル IDE と通信するコンテナや CI ジョブから AI を使用できます。 |
| シンプルなセキュリティモデル | 127.0.0.1 にバインドし、認証なし。同じマシン上のプロセスのみが呼び出せます。 |
シングルユーザーワークステーションには十分。共有マシンで追加の分離が必要かどうかはユーザーが判断する必要があります。 |
動作原理（高レベルアーキテクチャ）
- プラグイン起動 – IDE が起動すると、プラグインは IDE ごとに一意のデフォルトポート（例：IntelliJ は 29170、PyCharm は 29172）で
127.0.0.1にバインドされた HTTP サーバーを起動します。 - MCP リクエスト処理 – 各リクエストは、ツール（例：
ide_find_definition）を記述する JSON ペイロードです。プラグインはリクエストを IDE の内部 API（PSI、インデックス、リファクタリングエンジン）に転送し、構造化された JSON レスポンスを返します。 - ツールウィンドウ – 下部パネル UI がサーバーのステータスを表示し、設定 JSON のコピー、ポートの変更、個々のツールの有効/無効化ができます。
- クライアント設定 – AI アシスタントは、ローカルサーバー URL を指す小さな JSON スニペットで設定されます。README には、Claude、Codex、Cursor、Windsurf、および汎用 VS Code MCP クライアント用の既製コマンドが用意されています。
- ライフサイクル管理 – オプションのバックグラウンドコンポーネントがウィンドウフォーカスと MCP アクティビティを監視し、アイドルプロジェクトを自動的に低メモリの「休止」状態にし、新しい MCP 呼び出しが到着したときにウェイクします。
誰がこれを使うべきか？
| ユースケース | 利点 |
|---|---|
| AI 支援コーディング – Claude や Codex にコード提案をさせ、提案が正確なプロジェクト構造に基づくことを望む開発者。 | AI は IDE にシンボルの実際の定義を尋ね、正確な診断を取得し、安全にリファクタリングを適用できます。 |
| 自動コードレビュー / 一括リファクタリング – 大規模なマルチモジュールリポジトリでクラスを名前変更する必要があるスクリプト。 | プラグインのヘッドレス名前変更ツールはすべての参照を更新し、言語固有のルールを尊重します。 |
| CI / テストパイプライン – フル UI を起動せずに IDE を介して静的解析やビルドステップを実行。 | ide_build_project と ide_run_tests は IDE のビルドシステムをマシンフレンドリーな方法で公開します。 |
| マルチプロジェクトワークスペース – 多数の Maven/Gradle プロジェクトを扱う開発者。 | ライフサイクル管理は、積極的に編集されていないプロジェクトをスリープしてメモリを解放します。 |
はじめに（クイックステップ）
- JetBrains Marketplace（または提供された ZIP）からプラグインを インストール します。
- IDE を再起動 – MCP サーバーが自動的に起動します。
- 「Index MCP Server」 ツールウィンドウを開き、「Install on Coding Agents」 をクリックします。ボタンは適切な CLI コマンド（Claude、Codex）を実行するか、他のクライアント用に JSON 設定をコピーします。
- AI アシスタントの設定で、サーバー URL（例：
http://127.0.0.1:29170/index-mcp/streamable-http）を追加します。 - コーディングを開始 – アシスタントは IDE に定義を尋ね、安全なリファクタリングを実行し、診断を読み取ることができます。
制限とセキュリティに関する注意
- サーバーは ローカルのみ で 認証なし です。共有ワークステーションでは、任意のプロセスが書き込み可能なツール（名前変更、移動、編集）を呼び出す可能性があります。必要に応じて、書き込みツールを無効にするか、OS レベルのファイアウォールルールを使用することを検討してください。
- Rider はサポートされていません。ReSharper バックエンドが必要な PSI API を公開していないためです。
- 一部のツールは デフォルトで無効 です（例：
ide_read_file、ide_refactor_rename）。Settings → Tools → Index MCP Server → Exposed Tools で有効にする必要があります。
ライセンスと貢献
このプラグインは標準の JetBrains プラグインライセンス（リポジトリの LICENSE ファイルを参照）でリリースされています。プルリクエストによる貢献を歓迎します。ガイドラインについては、リポジトリの Contributing セクションを参照してください。
TL;DR
JetBrains Index MCP Server は、IDE の深いコード理解エンジンを、AI コーディングアシスタントが呼び出せるローカル HTTP サービスに変えます。多くの言語をサポートし、安全なリファクタリング、プロジェクトライフサイクル管理を提供し、人気の AI ツールとすぐに連携します。
関連
- プロジェクト
- プロジェクト
- プロジェクト
- プロジェクト
- プロジェクト