Serena

Serena は、MIT ライセンスの MCP ツールキットで、コーディングエージェントにコードベースの IDE レベルの理解を与えます。エージェントはファイル全体を1行ずつ読む代わりに、シンボルレベルのツールでセマンティック検索、編集、リファクタリング、デバッグを行えます。プロジェクトは「コーディングエージェントのための IDE」を名乗り、Claude Code、Codex、Cursor、Copilot CLI、MCP 対応 IDE などあらゆる MCP クライアントと接続できます。

主な機能

• シンボルレベルのセマンティック検索：言語サーバー経由でシンボル、参照、定義を解決。生のテキスト検索より正確。
• 原子的なリファクタリング：ファイルをまたぐ名前変更・移動・参照更新を1回の操作で実行。
• 言語サーバーバックエンド：多くのプログラミング言語を言語サーバーで正確に理解。
• JetBrains バックエンド：JetBrains IDE 内のワークフロー向けのプラグインモード。
• 柔軟な設定：グローバル、プロジェクト単位、クライアント単位、動的合成の設定フラグメントに対応。
• クライアント非依存：Model Context Protocol により、互換クライアントが同じツールを再利用可能。

使用シナリオ

• 大規模コードベース：ファイル全体の読み込みでトークンが膨らみ、クロスファイルの関係をエージェントが追い切れないチーム。
• モノレポ開発：パッケージ間の依存ジャンプ、参照検索、安全なリファクタリングが必要な開発者。
• エージェント中心の開発：Claude Code、Codex、Copilot CLI を使い、馴染みのないコードで編集を確実にしたいユーザー。
• コスト最適化：ファイル全体のコンテキストをシンボル検索に置き換え、入力トークンを削減したい組織。

料金プラン

Serena は MIT ライセンスで無料・オープンソースです。外部コストはローカル依存関係、主に uv と言語ごとのオプションの言語サーバーだけです。

はじめに

1. 必須の前提 uv をインストールします。
2. uv tool install -p 3.13 serena-agent を実行します。
3. serena init を実行し、成功メッセージを確認します。
4. 公式のクライアント設定ガイドに従い、MCP クライアントの起動コマンドを設定します。

よくある質問

対応クライアントは？

MCP に対応するクライアント全般で、Claude Code、Codex、Claude Desktop、MCP 対応 IDE、ローカル/Web GUI 向けの公式ガイドがあります。

主な制限は？

言語サーバーバックエンドには言語ごとの言語サーバーが必要で、セットアップコストがあります。小規模リポジトリでは仕組みのコストが見返りを上回る場合があります。

実行コストは高いですか？

ツールはローカルで動作し、大規模コードベースではシンボル検索によりトークン使用を大幅に削減できます。ただし効果はリポジトリ規模とクライアント設定に依存します。

代替案

• Continue：IDE 内にコンテキストを保つオープンソース AI コードアシスタント。
• Cline：VS Code 内で動作する自律コーディングエージェント。
• Aider：git リポジトリ向けのターミナル型ペアプログラミングエージェント。

ヒントとベストプラクティス

1. 大きなリポジトリから試す：ファイル全体の読み込みが高コストな場面で効果が最も明確です。
2. 公式インストールを使う：マーケットプレイス経由は古いインストールコマンドになるため非推奨とされています。
3. ワークフローガイドを読む：プロジェクトベースの設定でエージェントの編集品質が大きく変わります。

まとめ

Serena は、エージェントの壊れやすいテキスト編集をシンボル認識の IDE 級操作に変え、MCP 設計により Claude Code や Codex などで同じ設定を再利用できます。大規模・多言語のコードベースに取り組むチームは、言語サーバーのセットアップコストを許容できれば試す価値があります。