Xcode Index MCP

🚀 Xcode Index MCP

このツールは、Model Control Protocol (MCP) と IndexStoreDB を通じて、Goose/Cursor がiOS/macOSプロジェクトのインデックスにアクセスできるようにします。これにより、関数呼び出しサイトの詳細なリストが提供され、エージェントによるリファクタリングやコードナビゲーションを支援します。

🚀 クイックスタート

🔍 例のプロンプト

「MyViewController.swift の48行目の初期化子から myParameter を削除します。Xcode Index MCP を使用して、すべての参照が更新されるようにします。」

📦 インストール

1. uv（Pythonパッケージマネージャ）をインストールし、uv sync を実行します。

   brew install uv
   cd /path/to/this/repo
   uv sync
   

2. Swiftサービスをビルドします（Xcodeのインストールが必要です）。

   cd swift-service
   swift build
   

   この手順は、Xcodeのインデックスへのインターフェースを提供するために必要です。

3. 選択したエージェントにインストールします。

   Goose

設定に移動し、カスタム拡張を追加します。表示されるモーダルで、command フィールドの下に次の行を追加します。 bash uv run /Users/<USERNAME>/Development/xcode-index-mcp/.venv/bin/xcode-index-mcp 注意: <USERNAME> を実際のシステムユーザー名に置き換えてください。

残りの部分は次のようになるはずです。

#### Cursor

Settings > MCP > Add new global MCP server に移動します。mcp.json（通常はCursorの設定ディレクトリにあります）を次のように更新します。 json { "mcpServers": { "Xcode Index MCP": { "command": "uv", "args": ["run", "/Users/<USERNAME>/Development/xcode-index-mcp/.venv/bin/xcode-index-mcp"] } } } 注意: <USERNAME> を実際のシステムユーザー名に置き換えてください。

4. プロジェクト内の .gooseHints または cursorRules を更新して、エージェントにプラグインの使用方法を教えます。プロジェクト名を派生データフォルダに表示されるプロジェクト名に置き換えます。

   利用可能な場合は、ツール `xcode-index-mcp` を使用します。プロジェクト名は <ここにあなたのプロジェクト名> を使用します。このツールは、関数の呼び出しサイトと、呼び出しサイトからの関数定義を特定できます。リクエストにファイルパスが必要な場合は、`rg` を使用してファイルを検索し、`rg -n` を使用して行番号を検索します。ファイルからシンボルをリクエストする場合は、絶対パスを使用します。
   

   Cursorの場合は、独自のルールファイルにこれらの指示を追加することを検討してください。現時点では、CursorはMCPの instructions フィールドを読み取らないと思われます。

💻 テストの実行

Swiftのテストを実行するには、swift-service ディレクトリに移動して swift test を実行します。

🔧 技術詳細

このツールは、2つの主要なコンポーネントで構成されています。

1. src ディレクトリにあるMCPサーバーで、Goose/Cursorとの通信を処理します。
2. swift-service ディレクトリにあるSwiftサービスで、Appleの IndexStoreDB パッケージを使用してXcodeのインデックスとインターフェースを提供します。

MCPサーバーが 'load_index' を呼び出すと、SwiftサービスはXcodeの派生データディレクトリを検索してプロジェクトファイルを探します。見つかった場合は、プロジェクトのインデックスをロードしようとします。クエリは、MCPサーバーから、IndexStoreDB で提供されるメソッドのサブセットを通じてインデックスに渡されます。