Serena
Serena とは？
AIコーディングの常識が変わる！Claudeを”覚醒”させる知性、「Serena」徹底解説｜Kyutaro
Serenaは、一言でいうと「AI（特にClaude）に、あなたのプロジェクトコードを深く理解させるための賢い通訳者」です。 これは、Anthropic社が提唱するMCP (Model Context Protocol)という規格を使って、AIと連携するツールの一種です。
🔍 例えるなら…
今までのAIコーディングは、分厚い専門書（あなたのプロジェクトコード）を、目次も索引も使わずに1ページ目から全部読んで、目的の情報を探すようなものでした。これでは時間もかかるし、途中で疲れてしまいますよね。 Serenaは、この専門書のために非常に優秀な「目次」と「索引」を自動で作成してくれる秘書のような存在です。AIはSerenaに「〇〇という関数の定義はどこ？」と聞くだけで、瞬時に該当ページ（コードの該当箇所）を開くことができるようになるのです。 これにより、AIは無駄なページを読む必要がなくなり、トークンの消費量を劇的に削減し、処理速度と精度を飛躍的に向上させることができます。
Serena MCP の導入手順
Claude Codeを10倍賢くする無料ツール「Serena」の威力とトークン効率化術
1. 導入
まずは、Serena MCP を導入します。 そのために、Python の `uv` というパッケージ管理ツールをインストールする必要があります。
私の場合、`mise` を使っているので、以下のように導入していきます。
mise use uv@latest2. MCP 連携
次に、MCP 連携をしていきます。 プロジェクトディレクトリに移動し、以下のコマンドを実行します。 -s project にすると、.mcp.json に絶対パスが含まれるので、local にしておく
claude mcp add serena -s local -- uvx --from git+https://github.com/oraios/serena serena-mcp-server --context ide-assistant --project $(pwd)正常に MCP サーバが起動すると、ブラウザで以下のダッシュボードが開き、ログを確認できます：
表示されるログの一例：
run server3. 初期コマンド実行
連携完了後、`claude` を起動した状態で、以下のコマンドを実行します。 これにより Serena の初期インストラクションが読み込まれ、`.serena/project.yml` が作成されます。
/mcp__serena__initial_instructionsこのコマンドでは、コードの解析などを Serena が実行し、Serena を利用できる状態にします。
Serena プロジェクト設定（.serena/project.yml）
Claude CodeでMCPツール（Context7、Serena、Cipher）を活用してAIコーディングを次のレベルへ #ClaudeCode
project_name: "my-awesome-project"
language: typescript # python, rust, go, java など
entry_points:
- src/index.ts
- src/app.ts
ignored_dirs:
- node_modules
- .git
- dist
- coverage
- __pycache__
- public/images # 画像ディレクトリを除外
ignored_files:
- "*.log"
- "*.tmp"
- ".env*"
- "*.jpg"
- "*.png"
- "*.pdf"
- "*.zip"
max_file_size: 1048576 # 1MB（バイナリも含む総バイト数）
show_logs: true
use_lsp: true
# セキュリティ設定
security:
exclude_sensitive:
- "**/*.key"
- "**/*.pem"
- "**/secrets/**"
sanitize_logs: true導入が完了したので、次は実際にどんな使い方ができるのかを見ていきましょう。
オンボーディング
オンボーディングの目的は、Serena がプロジェクトのコードベースを理解し、将来のインタラクションで利用するメモリを構築すること。 プロジェクトの最初か、大規模な編集を行ったときに、プロンプトで下記を実行。
Serena のオンボーディングを開始してください。