Claude IDE Tools — JetBrainsのリファクタリング能力をClaude Codeへ

Tool
Claude IDE Tools — JetBrainsのリファクタリング能力をClaude Codeへ

Claude IDE Tools — JetBrainsのリファクタリング能力をClaude Codeへ

JetBrains製IDEの高度なセマンティック解析・リファクタリング機能を、Claude Code CLIから利用できるようにする非公式プラグイン／ツール群。Model Context Protocol (MCP) を介してIDE内部のPSIやリファクタリングエンジンを呼び出し、単純なテキスト検索では得られない安全なリネームや参照検索、移動などを実現します。（約300字）

https://github.com/link1107/claude-ide-tools

概要

Claude IDE Toolsは、JetBrains系IDE（IntelliJ IDEA, PyCharm, WebStormなど）が持つセマンティックなコード解析と強力なリファクタリング機能を、Claude CodeのCLIから利用可能にするプロジェクトです。従来の単純なテキストベースの検索・置換とは異なり、IDEのPSI（構文木）やリファクタリングAPIを使うことで安全に変数名変更、クラス移動、参照検索を行えます。Model Context Protocol（MCP）を通じてClaudeとIDEを連携させ、コードの意味を理解した上での操作をCLI経由で自動化・拡張できます。

GitHub

リポジトリの統計情報

  • スター数: 4
  • フォーク数: 0
  • ウォッチャー数: 4
  • コミット数: 21
  • ファイル数: 15
  • メインの言語: JavaScript

主な特徴

  • JetBrains IDEのセマンティック解析を外部ツール（Claude Code）から利用可能にする。
  • 安全なリネーム、参照検索、シンボル移動など、IDEのリファクタリング機能を透過的に提供。
  • Model Context Protocol（MCP）を用いた通信で、CLI→IDE間の命令とコンテキスト共有を実現。
  • 複数のJetBrains製IDEに対応し、プロジェクトのインデックスやPSI情報を活用することで誤検出を低減。

技術的なポイント

このプロジェクトの核は「IDEの内部情報を外部から安全に利用するための橋渡し」です。通常、リファクタリングや参照検索はIDE内部のPSI（Program Structure Interface）やインデックスに依存しますが、Claude IDE ToolsはMCPを介してこれらの情報と操作を外部リクエストに公開します。具体的には、CLI側（Claude Code）が「あるクラスの参照を列挙して」「変数名を安全にリネームしてほしい」といった命令を送り、IDE側プラグインがその命令を受け取ってPSI解析・リファクタリングAPIを実行し、結果や変更プレビューを返す流れです。

このアプローチの利点は、単なる正規表現やgrepベースの置換で発生しがちな誤置換を防げる点にあります。IDEは型情報やスコープ、インポート解決、言語固有の構文規則を理解しているため、例えば同名の別シンボルを誤って書き換えるリスクを低減できます。また、移動や抽出など複数ファイルにまたがる変更もIDEが提供するトランザクション的な変更適用で一貫性を保てます。

実装面では、通信レイヤー（MCPメッセージの送受信）、命令のマッピング（CLI要求→IDE API呼び出し）、および安全性・ユーザー確認のためのプロンプトやプレビュー生成が重要です。加えて、IDEがプロジェクトを完全にインデックスしていることが前提であるため、初回実行時や大規模リポジトリではスローダウンや部分的な応答遅延が生じる可能性があります。セキュリティ面では、IDE内部のコード情報を外部プロセスが利用する設計のため、通信経路の保護やアクセス制御、ローカル限定通信などの対策が求められます。ライセンスはApache-2.0で、OSSコミュニティの改変・利用を比較的自由に許可しています。

プロジェクトの構成

主要なファイルとディレクトリ：

  • .gitattributes: file
  • .github: dir
  • .gitignore: file
  • .idea: dir
  • LICENSE: file

…他 10 ファイル

（補足）READMEには本プロジェクトが「Claude Code CLIからJetBrains IDEのリファクタリング機能を利用可能にする」と明記されており、ライセンスバッジ（Apache 2.0）も掲載されています。実際の導入方法やMCPメッセージ仕様、サポートするリファクタリング操作の一覧はリポジトリ内のドキュメントに従ってください。

まとめ

JetBrainsの強力な解析・リファクタリング能力をClaudeに統合する実用的な橋渡しツール。

リポジトリ情報：

READMEの抜粋：

Claude IDE Tools

License

A JetBrains IDE plugin that exposes powerful refactoring capabilities to Claude Code CLI via Model Context Protocol (MCP). Works with all major JetBrains IDEs.

What It Does

This plugin allows Claude Code to use JetBrains IDEs’ semantic code analysis instead of simple text-based grep/search. When you ask Claude to find usages of a class or rename a variable,…