setup-serena-mcp

ユーザー入力：

$ARGUMENTS

Serena MCP サーバーのセットアップガイド

1. セットアップのコンテキストを確認する

設定をどこに保存するか、ユーザーに尋ねます。

選択肢：

1. プロジェクトレベル（Git 経由で共有） - バージョン管理で追跡され、チームと共有される設定

   • CLAUDE.md の更新先：./CLAUDE.md

2. プロジェクトレベル（個人設定） - 設定はローカルに保持され、Git では追跡されません

   • CLAUDE.md の更新先：./CLAUDE.local.md
   • これらのファイルが .gitignore に記載されていることを確認し、記載されていなければ追加します

3. ユーザーレベル（グローバル） - このユーザーのすべてのプロジェクトに適用される設定

   • CLAUDE.md の更新先：~/.claude/CLAUDE.md

ユーザーの選択を保存し、以降の手順では適切なパスを使用します。

2. Serena MCP サーバーがすでにセットアップされているか確認する

Serena MCP サーバーのツール（例：find_symbol または get_symbols_overview）を使用してみて、アクセスできるかどうかを確認します。

アクセスできない場合は、セットアップに進みます。

3. Serena のドキュメントを読み込む

Serena の機能とセットアップ手順を理解するため、以下のドキュメントを読み込みます。

• Serena とは何か、どのような機能があるかを理解するため、https://raw.githubusercontent.com/oraios/serena/refs/heads/main/README.md を読み込みます
• Serena の実行方法を確認するため、https://oraios.github.io/serena/02-usage/020_running.html を読み込みます
• MCP クライアントの設定方法を確認するため、https://oraios.github.io/serena/02-usage/030_clients.html を読み込みます
• プロジェクトで Serena をセットアップする方法を確認するため、https://oraios.github.io/serena/02-usage/040_workflow.html を読み込みます

4. セットアップ手順をユーザーに案内する

読み込んだドキュメントに基づき、以下の手順を案内します。

1. 前提条件を確認する：Serena の実行に必要な uv がインストールされていることを確認します
2. クライアントの種類を特定する：ユーザーが使用している MCP クライアント（Claude Code、Claude Desktop、Cursor、VSCode など）を特定します
3. セットアップ手順を提示する：まだ設定されていない場合は、使用するクライアントに合わせた設定手順を案内します
4. プロジェクトをセットアップする：まだセットアップされていない場合は、プロジェクトのセットアップ手順を案内します
5. プロジェクトのインデックス作成を開始する：セットアップ直後の場合は、プロジェクトのインデックス作成手順を案内します
6. MCP をセットアップした直後の場合、新しい MCP サーバーを読み込むために Claude Code を再起動するようユーザーに尋ね、以下を含む明示的な手順をユーザー向けに記述します。「Claude Code のコンソールを終了し、claude --continue を実行してから、セットアップを続けるために「continue」と入力してください」
7. 接続をテストする：セットアップ後、Serena のツールにアクセスできることを確認します
   1. まだアクセスできない場合は、initial_instructions を実行します
   2. オンボーディングが実施済みか確認し、未実施の場合は実行します。
   3. その後、任意のファイルを読み取ってみます

MCP サーバーを追加した後、接続をテストする前に、次のメッセージをユーザーにそのまま書きます。

You must restart Claude Code to load the new MCP server:

  1. Exit Claude Code console (type exit or press Ctrl+C)
  2. Run claude --continue
  3. Type "continue" to resume setup

  After restart, I will:
  - Verify Serena tools are accessible
  - Run initial_instructions if needed
  - Perform onboarding for this project (if not already done)

5. CLAUDE.md ファイルを更新する

手順 1 で決定したパスを使用します。Serena のセットアップが正常に完了したら、適切な CLAUDE.md ファイルを以下の内容でそのまま更新します。

### Use Serena MCP for Semantic Code Analysis instead of regular code search and editing

Serena MCP is available for advanced code retrieval and editing capabilities.

**When to use Serena:**
- Symbol-based code navigation (find definitions, references, implementations)
- Precise code manipulation in structured codebases
- Prefer symbol-based operations over file-based grep/sed when available

**Key tools:**
- `find_symbol` - Find symbol by name across the codebase
- `find_referencing_symbols` - Find all symbols that reference a given symbol
- `get_symbols_overview` - Get overview of top-level symbols in a file
- `read_file` - Read file content within the project directory

**Usage notes:**
- Memory files can be manually reviewed/edited in `.serena/memories/`

サーバーをユーザーレベル（グローバル）でセットアップした場合は、次のセクションを追加します。

**Project setup (per project):**
1. Run `serena project create --index` in your project directory
2. Serena auto-detects language; creates `.serena/project.yml`
3. First use triggers onboarding and creates memory files in `.serena/memories/`

6. プロジェクトの初期化（必要な場合）

新しいプロジェクトの場合、または Serena が初期化されていない場合：

1. プロジェクトの初期化コマンドを実行するようユーザーに案内します
2. プロジェクトベースのワークフローとインデックス作成について説明します
3. 必要に応じて、プロジェクト固有の設定を行います