追記 2025年8月16日
なぜSerena MCPを使うのかの理由を知りたい人は必読！
話題のSerenaMCPの仕組みを解説！ - izanami
追記終了
GitHub Copilotシリーズ
はじめに
最近 Claude Code やKiro などプロジェクト全体を監視して、コードを書いたり、要件定義や設計やタスクリストを自動で作成したりと進化が激しいです。
一方、GitHub Copilotは全体をみるというよりも、現在の開いているファイルを手助けするというかんじです。
どうやらプロジェクト全体を見てくれてない、もしくは見ているのは少しだけというイメージがあります。
そこで 👇️ Serena MCP を使います。
oraios/serena: A powerful coding agent toolkit providing semantic retrieval and editing capabilities (MCP server & Agno integration)
この Serena MCP はプロジェクトやワークスペース全体を把握してくれるMCPとなります。
それでは早速インストールからしてみましょう。
前提条件
VSCode インストール済み
GitHub Copilot有効化済み
uv と uvx が使用可能
最初に設定しておくこと
git config --global core.autocrlf
をtrueにします。
余計な差分を作らないため
git config --global core.autocrlf true
で有効化します。
動くかどうかの動作確認
👇️ターミナル(黒い画面)から実行してみてください。
uvx --from git+https://github.com/oraios/serena serena start-mcp-server
実行すると Serena MCP のダッシュボードがブラウザで自動的に開きます。
ターミナルで停止(Ctrl+C)すると終了します。
MCPの設定ファイルの場所
VSCodeのMCP設定ファイルは
mcp.json
に記載されています。
この設定ファイルは・・・
MCP設定ファイルの場所
Windows11
C:\Users\[ユーザー名]\AppData\Roaming\Code\User\mcp.json
もしくはワークスペース、リポジトリのルートに .vscode/mcp.json ファイルを作ってそこに書き込みます。
ここには (C:\Users[ユーザー名]\AppData\Roaming\Code\User) VSCodeの
settings.json
keybindings.json
が置かれている場所と同じです。
Serena の設定は、mcp.json ファイル内で以下のように定義されています：
{
"servers": {
"serena": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/oraios/serena",
"serena",
"start-mcp-server",
"--context",
"ide-assistant"
]
},
...
👆️ オプションに --context ide-assistant を設定しています。
このオプションはVSCodeなどのIDEに対してアシストをするために必要みたいです。
設定が完了したら起動ボタンを押してみてください。
インストールが成功すると、
serenaのサーバ起動がローカルから確認できます。
http://127.0.0.1:24282/dashboard/index.html
👆️このダッシュボードが自動で開きます。
クライアントによる Serena MCP サーバーの起動: MCPサーバーは通常、クライアントアプリケーションによってサブプロセスとして実行されます。 そのため、ユーザーが手動でサーバーを起動する必要はほとんどなく、クライアントの設定を通じて Serena MCP を起動するコマンドが提供されます。要はGitHub Copilotが自動で使ってくれれます、GitHub Copilotにプロジェクトを指定することでアクティベート状態になります。 プロジェクトの指示書などに書いておきます。
使い方
プロジェクトへの名前や絶対パスなどを教えることで
Serenaは「アクティベート」します。
アクティベートとは
特定のプロジェクトをSerenaが認識し、そのプロジェクトに対する作業コンテキストを確立するプロセスを指します。
アクティベートすることでSerenaはそのプロジェクトやワークスペースに対して有効化されます。
プロジェクトのアクティベート
プロジェクトを VSCode で開き、
例えば
「現在のプロジェクトを Serena MCP を利用して分析してください。」
と GitHub Copilot にお願いします。
ブラウザで自動的に
http://127.0.0.1:24283/dashboard/index.html
このダッシュボードが開きました。
👆実行中のスクリーンショット
分析に数分待ちます。
分析が終了すると・・・
この結果は、プロジェクトのルートに .serenaが作成され、そこに保存されます。
プロジェクトでの使い方
GitHub Copilotの指示書(.github/copilot-instructions.mdなど)に書いておきます。
*「プロジェクト /path/to/my_project を有効化する」
*「プロジェクト my_project を有効化する」
👆️絶対パスで指定したり、プロジェクト名を指定します。
私は絶対パスで指定することをオススメします。
あと、ワークスペースも指定できるようですが、[ワークスペース名].code-workspaceを指定すればいいようです。(未確認)
Serena MCP の利用方法は３つあり、そのうち１つを紹介しました。
- ux (ローカルインストール)
- uvx 今回の方法(サーバーインストール)
- Agno を使う(プロジェクト内で使う)
Agnoとは
Serenaをエージェントとして利用するためのフレームワークであり、MCPサーバーのインストール方法とは少し性質が異なるものです。
以上です、お疲れ様でした。
以下、NotebookLMによる分析情報
👇️この記事と、Serena MCPのGitHub リポジトリをNotebookLMに与え、分析してもらいました。
承知いたしました。提供された情報を整理し、Serenaに関するブログ記事として見やすく構成します。
Serena の強力な機能：開発者のためのインテリジェントなコードアシスタント
この記事では、Serena の核となる機能と、それが開発ワークフローをどのように向上させるかについて詳しく掘り下げます。
Serena の核となる強み：セマンティック解析能力を強調
Serena は単にテキストベースでコードを解析するツールではありません。記事では「プロジェクト全体を把握」とありますが、これは Serena が 言語サーバー（Language Server Protocol: LSP） に基づいて、コードをシンボルレベルで深く理解しているからこそ実現します。これにより、Serena はセマンティックなコードの取得や編集が可能です。まるでベテラン開発者が IDE の機能を使うように、正確なコンテキストを特定し、適切なコードの変更を行えます。
他のツールが RAG（Retrieval-Augmented Generation）ベースやテキストベースの分析に依存する一方で、Serena がシンボル理解に基づく点で優れており、より高精度なコード操作を可能にします。
大規模プロジェクトにおけるインデックス作成の推奨
大規模なプロジェクトで Serena のツールを高速化するためには、プロジェクトのインデックスを作成することが強く推奨されます。この手順を行うことで、初回ツール使用時の遅延が大幅に改善されます。
コマンド例: プロジェクトディレクトリ内で以下を実行します。
serena index create
--context ide-assistant の詳細な利点
--context ide-assistant オプションは、IDE でのコードアシストに不可欠です。このオプションは、シンボリックな操作のためのツールを提供し、GitHub Copilot のようなクライアントのパフォーマンスを向上させる効果があります。これにより、よりスムーズでインテリジェントな開発体験が提供されます。
Serena ダッシュボードのさらなる活用法
Serena ダッシュボードは、単に開くだけのものではありません。セッション中のログ表示、Serena ツールの使用統計（record_tool_usage_stats: True 設定時）、そして特にクライアントが MCP サーバープロセスを適切に終了できない場合に発生する「ゾンビプロセス」を防ぐための安全なシャットダウン機能を提供します。これらの機能により、Serena をより効率的かつ安定して利用できます。
プロジェクトのアクティベートに関する補足
「GitHub Copilot が自動で使ってくれくれます、GitHub Copilot にプロジェクトを指定することでアクティベート状態になります。」という記述について、より正確には、
「GitHub Copilotが Serena の activate_project ツールを使用してプロジェクトをアクティベートし、ユーザーは LLM に対してその指示を与えることで Serena がプロジェクトのコンテキストを確立します」
というニュアンスです。これにより、Serena と LLM の役割分担がより明確になります。
セキュリティに関する注意点
execute_shell_command ツールは任意のシェルコマンドを実行できるため、セキュリティ上のリスクがあることに留意してください。通常、MCP サーバー経由で利用する場合、クライアントはユーザーに実行許可を求めます。しかし、Agno UI のようにユーザーの許可を求めないケースもあるため、注意が必要です。
Serena では、特定のツールを無効にしたり、プロジェクト設定ファイル（.serena/project.yml）で 読み取り専用モード（read_only: true） を有効にしたりすることで、コードベースの変更を完全に禁止できます。これにより、より安心して Serena を利用することが可能です。
モード（Modes）についての簡単な紹介
コンテキストが Serena の起動時に設定され、セッション中に変更できない静的な環境定義であるのに対し、モードはセッション中に動的に切り替え可能です。特定のタスクやインタラクションスタイルに合わせて Serena の挙動を微調整できるため、Serena の柔軟性が向上します。
オンボーディングとメモリーの機能
Serena がプロジェクトに初めて適用される際、 「オンボーディングプロセス」 を実行し、プロジェクト構造を学習します。また、Serena はプロジェクトディレクトリ内の .serena/memories/ に 「メモリー」 を保存し、将来の対話でそれを活用することでユーザーエクスペリエンスを大幅に向上させます。これにより、Serena のインテリジェンスが際立ちます。
Serena の費用対効果の再強調
Serena は 「無料でオープンソース」 であり、多くの有料 IDE ベースや API ベースのエージェントと比較して、「サブスクリプションや API キーが不要で、費用がかからない（特に Claude の無料ティアなどと連携した場合）」という大きな利点があります。この費用対効果の高さは、開発者が Serena を導入する大きな動機となるでしょう。
Serena は、そのセマンティック解析能力、実用的なインデックス作成機能、詳細なコンテキスト制御、そしてコストパフォーマンスの高さにより、現代の開発ワークフローにおいて強力な味方となります。ぜひその機能を体験してみてください。
追記 2025年8月9日
グローバルの設定ファイルの場所
Windowsの場合
C:\Users\[ユーザー名]\.serena\serena_config.yml
グローバルの設定ファイルの翻訳
例えば、設定ファイルの👇この箇所
web_dashboard: true
# Serena Webダッシュボード（Webブラウザからアクセス可能）を開くかどうか
# 現在のセッションログを表示します - すべてのプラットフォームでサポートされている
# GUIログウィンドウの代替手段です
...
web_dashboard_open_on_launch: false
# Serenaの起動時にWebダッシュボードでブラウザウィンドウを開くかどうか（web_dashboard
# が有効な場合）。Falseに設定した場合でも、Webブラウザで手動で
# http://localhost:24282/dashboard/ にアクセスしてダッシュボードを開くことができます
# （24282 = 0x5EDA、SErena DAshboard）。
# 複数のインスタンスが実行されている場合は、より高いポートが使用されます。ポート24283、24284などを試してください。
👆この箇所の web_dashboard: true web_dashboard_open_on_launch: false に設定すると、ブラウザでダッシュボードが開かなくなります。
👇Serena グローバルの設定ファイルの全訳
gui_log_window: false
# Serenaのログを表示するグラフィカルウィンドウを開くかどうか
# 主にWindowsと（部分的に）Linuxでサポートされており、macOSでは利用できません
# ログをWebブラウザで表示したい場合は、代わりに `web_dashboard` オプションを使用してください
# 制限事項: Linux版Claude Desktop のコミュニティ版では動作しないようです
# 一部のMCPクライアントで問題を引き起こす可能性もあります - 問題が発生した場合は、この機能を無効にしてください
# ログを検査できることは、トラブルシューティングやツール呼び出しの監視に役立ちます
# 特にagno playgroundを使用する場合、ツール呼び出しが常に表示されるわけではなく
# agno UIでは入力パラメータが表示されないため、ログの確認は重要です
# Claude Desktop のMCPサーバーとして使用する場合、ログは主にトラブルシューティング用です
# 注意: 残念ながら、Serenaサーバーやエージェントを起動するさまざまなエンティティは
# 謎めいた方法で起動し、以前のインスタンスをシャットダウンせずに複数のプロセスインスタンスを
# 開始することがよくあります。これにより、複数のログウィンドウが開かれ、最後の
# ウィンドウのみが更新される可能性があります。agnoやClaude DesktopがSerenaを起動する方法を
# 制御できないため、現時点ではこの制限と共存する必要があります。
web_dashboard: true
# Serena Webダッシュボード（Webブラウザからアクセス可能）を開くかどうか
# 現在のセッションログを表示します - すべてのプラットフォームでサポートされている
# GUIログウィンドウの代替手段です
web_dashboard_open_on_launch: true
# Serenaの起動時にWebダッシュボードでブラウザウィンドウを開くかどうか（web_dashboard
# が有効な場合）。Falseに設定した場合でも、Webブラウザで手動で
# http://localhost:24282/dashboard/ にアクセスしてダッシュボードを開くことができます
# （24282 = 0x5EDA、SErena DAshboard）。
# 複数のインスタンスが実行されている場合は、より高いポートが使用されます。ポート24283、24284などを試してください。
log_level: 20
# GUIログウィンドウとダッシュボードの最小ログレベル（10 = debug、20 = info、30 = warning、40 = error）
trace_lsp_communication: false
# SerenaとLanguage Serverとの通信をトレースするかどうか
# これはLanguage Serverの問題をデバッグする際に役立ちます
tool_timeout: 240
# ツールの実行がタイムアウトするまでの時間（秒）
excluded_tools: []
# グローバルに除外するツールのリスト
included_optional_tools: []
# 含めるオプションツール（デフォルトで無効）のリスト
jetbrains: false
# JetBrainsモードを有効にし、Language Serverベースのツールの代わりに
# Serena JetBrains IDEプラグインベースのツールを使用するかどうか
# 注意: このプラグインはまだリリースされていません。これはSerena開発者専用です。
record_tool_usage_stats: false
# ツール使用統計を記録するかどうか。記録がアクティブな場合、Webダッシュボードに表示されます
token_count_estimator: TIKTOKEN_GPT4O
# `record_tool_usage` が True の場合のみ関連します。ツール使用統計に使用するトークン数推定器の名前
# 利用可能なオプションについては、`RegisteredTokenCountEstimator` 列挙型を参照してください
#
# 注意: いくつかのトークン推定器（tiktokenなど）は、初回実行時にデータファイルの
# ダウンロードが必要で、時間がかかりインターネットアクセスが必要な場合があります。
# Anthropic系など他の推定器は、APIキーが必要でレート制限が適用される場合があります。
# SERENA によって管理されています。YAMLの最下部に保持し、必要がない限り編集しないでください
# 登録されたプロジェクトのリスト
# プロジェクトを追加するには、チャット内で単に「プロジェクト /path/to/project を有効化する」または
# プロジェクトが以前に追加されている場合は「プロジェクト <プロジェクト名> を有効化する」と指示してください
# デフォルトでは、プロジェクト名はプロジェクトを含むディレクトリの名前になりますが
# （自動生成される）プロジェクト設定ファイル `/path/project/project/.serena/project.yml` を
# 編集することで変更できます
# プロジェクト設定を完全に制御したい場合は、project.ymlファイルを手動で作成してから
# 初回有効化時にパスによってプロジェクトを有効化するようSerenaに指示してください
# 注意: 登録されたプロジェクトの名前に衝突がないことを確認してください
projects:
- C:\src\******
追記終了