Xcode MCP使用ガイドライン(AIエージェント向け)

name: xcode-mcp-for-pi-agent description: mcporter CLIを介した効率的なXcode MCPツール使用のためのガイドライン。このスキルは、Xcode MCPツールをいつ使用すべきか、標準ツールをいつ使用すべきかを理解するために使用する。Xcode MCPは多くのトークンを消費するため、ビルド、テスト、シミュレータ、プレビュー、SourceKit診断にのみ使用すること。ファイルの読み書きやgrep操作には絶対に使用しないこと。Xcodeプロジェクト、iOS/macOSビルド、SwiftUIプレビュー、Appleプラットフォーム開発を扱う際は常にこのスキルを使用すること。 # Xcode MCP使用ガイドライン Xcode MCPツールは、MCPサーバーを標準コマンドラインツールにブリッジする`mcporter` CLIを介してアクセスする。このスキルは、Xcode MCPをいつ使用すべきか、標準ツールをいつ優先すべきかを定義する。 ## セットアップ Xcode MCPは`~/.mcporter/mcporter.json`で設定する必要がある: ```json { "mcpServers": { "xcode": { "command": "xcrun", "args": ["mcpbridge"], "env": {} } } } ``` 接続を確認する: ```bash mcporter list xcode ``` --- ## ツールの呼び出し すべてのXcode MCPツールはmcporterを介して呼び出される: ```bash # 利用可能なツールを一覧表示 mcporter list xcode # キー:値の引数でツールを呼び出す mcporter call xcode.<tool_name> param1:value1 param2:value2 # 関数呼び出し構文で呼び出す mcporter call 'xcode.<tool_name>(param1: "value1", param2: "value2")' ``` --- ## Xcode MCPツール完全リファレンス ### ウィンドウとプロジェクト管理 | ツール | mcporter呼び出し | トークンコスト | |------|---------------|------------| | 開いているXcodeウィンドウを一覧表示（tabIdentifierを取得） | `mcporter call xcode.XcodeListWindows` | 低 | ### ビルド操作 | ツール | mcporter呼び出し | トークンコスト | |------|---------------|------------| | Xcodeプロジェクトをビルド | `mcporter call xcode.BuildProject` | 中 | | エラー/警告を含むビルドログを取得 | `mcporter call xcode.GetBuildLog` | 中 | | Issue Navigatorの課題を一覧表示 | `mcporter call xcode.XcodeListNavigatorIssues` | 低 | ### テスト | ツール | mcporter呼び出し | トークンコスト | |------|---------------|------------| | テストプランから利用可能なテストを取得 | `mcporter call xcode.GetTestList` | 低 | | すべてのテストを実行 | `mcporter call xcode.RunAllTests` | 中 | | 特定のテストを実行（推奨） | `mcporter call xcode.RunSomeTests` | 中 | ### プレビューと実行 | ツール | mcporter呼び出し | トークンコスト | |------|---------------|------------| | SwiftUIプレビュースナップショットをレンダリング | `mcporter call xcode.RenderPreview` | 中 | | ファイルコンテキストでコードスニペットを実行 | `mcporter call xcode.ExecuteSnippet` | 中 | ### 診断 | ツール | mcporter呼び出し | トークンコスト | |------|---------------|------------| | 特定ファイルのコンパイラ診断を取得 | `mcporter call xcode.XcodeRefreshCodeIssuesInFile` | 低 | | SourceKit診断を取得（開いているすべてのファイル） | `mcporter call xcode.getDiagnostics` | 低 | ### ドキュメント | ツール | mcporter呼び出し | トークンコスト | |------|---------------|------------| | Apple Developerドキュメントを検索 | `mcporter call xcode.DocumentationSearch` | 低 | ### ファイル操作（高トークン - 絶対に使用しない） | MCPツール | 代わりに使用 | 理由 | |----------|-------------|-----| | `xcode.XcodeRead` | `Read`ツール / `cat` | 高トークン消費 | | `xcode.XcodeWrite` | `Write`ツール | 高トークン消費 | | `xcode.XcodeUpdate` | `Edit`ツール | 高トークン消費 | | `xcode.XcodeGrep` | `rg` / `grep` | 高トークン消費 | | `xcode.XcodeGlob` | `find` / `glob` | 高トークン消費 | | `xcode.XcodeLS` | `ls`コマンド | 高トークン消費 | | `xcode.XcodeRM` | `rm`コマンド | 高トークン消費 | | `xcode.XcodeMakeDir` | `mkdir`コマンド | 高トークン消費 | | `xcode.XcodeMV` | `mv`コマンド | 高トークン消費 | --- ## 推奨ワークフロー ### 1. コード変更とビルドフロー ``` 1. コードを検索 -> rg "pattern" --type swift 2. ファイルを読む -> Readツール / cat 3. ファイルを編集 -> Editツール 4. 構文チェック -> mcporter call xcode.getDiagnostics 5. ビルド -> mcporter call xcode.BuildProject 6. エラーを確認 -> mcporter call xcode.GetBuildLog（ビルドが失敗した場合） ``` ### 2. テスト作成と実行フロー ``` 1. テストファイルを読む -> Readツール / cat 2. テストを書く/編集 -> Editツール 3. テスト一覧を取得 -> mcporter call xcode.GetTestList 4. テストを実行 -> mcporter call xcode.RunSomeTests（特定のテスト） 5. 結果を確認 -> テスト出力を確認 ``` ### 3. SwiftUIプレビューフロー ``` 1. ビューを編集 -> Editツール 2. プレビューをレンダリング -> mcporter call xcode.RenderPreview 3. 反復 -> 必要に応じて繰り返す ``` ### 4. デバッグフロー ``` 1. 診断を確認 -> mcporter call xcode.getDiagnostics 2. プロジェクトをビルド -> mcporter call xcode.BuildProject 3. ビルドログを取得 -> mcporter call xcode.GetBuildLog severity:error 4. 問題を修正 -> Editツール 5. 再ビルド -> mcporter call xcode.BuildProject ``` ### 5. ドキュメント検索 ``` 1. ドキュメントを検索 -> mcporter call xcode.DocumentationSearch query:"SwiftUI NavigationStack" 2. 結果を確認 -> 実装で情報を使用 ``` --- ## フォールバックコマンド（MCPまたはmcporterが利用できない場合） Xcode MCPが切断されている、mcporterがインストールされていない、または接続が失敗した場合は、次のxcodebuildコマンドを直接使用する: ### ビルドコマンド ```bash # デバッグビルド（シミュレータ）- <SchemeName>をプロジェクトのスキームに置き換える xcodebuild -scheme <SchemeName> -configuration Debug -sdk iphonesimulator build # リリースビルド（デバイス） xcodebuild -scheme <SchemeName> -configuration Release -sdk iphoneos build # ワークスペースでのビルド（CocoaPodsプロジェクト用） xcodebuild -workspace <ProjectName>.xcworkspace -scheme <SchemeName> -configuration Debug -sdk iphonesimulator build # プロジェクトファイルでのビルド xcodebuild -project <ProjectName>.xcodeproj -scheme <SchemeName> -configuration Debug -sdk iphonesimulator build # 利用可能なスキームを一覧表示 xcodebuild -list ``` ### テストコマンド ```bash # すべてのテストを実行 xcodebuild test -scheme <SchemeName> -sdk iphonesimulator \ -destination "platform=iOS Simulator,name=iPhone 16" \ -configuration Debug # 特定のテストクラスを実行 xcodebuild test -scheme <SchemeName> -sdk iphonesimulator \ -destination "platform=iOS Simulator,name=iPhone 16" \ -only-testing:<TestTarget>/<TestClassName> # 特定のテストメソッドを実行 xcodebuild test -scheme <SchemeName> -sdk iphonesimulator \ -destination "platform=iOS Simulator,name=iPhone 16" \ -only-testing:<TestTarget>/<TestClassName>/<testMethodName> # コードカバレッジ付きで実行 xcodebuild test -scheme <SchemeName> -sdk iphonesimulator \ -configuration Debug -enableCodeCoverage YES # 利用可能なシミュレータを一覧表示 xcrun simctl list devices available ``` ### クリーンビルド ```bash xcodebuild clean -scheme <SchemeName> ``` --- ## クイックリファレンス ### mcporter + Xcode MCPを使用する場合: - `xcode.BuildProject` - ビルド - `xcode.GetBuildLog` - ビルドエラー - `xcode.RunSomeTests` - 特定のテストの実行 - `xcode.GetTestList` - テストの一覧表示 - `xcode.RenderPreview` - SwiftUIプレビュー - `xcode.ExecuteSnippet` - コード実行 - `xcode.DocumentationSearch` - Appleドキュメント - `xcode.XcodeListWindows` - tabIdentifierの取得 - `xcode.getDiagnostics` - SourceKitエラー ### Xcode MCPを絶対に使用しない場合: - `xcode.XcodeRead` -> `Read`ツール / `cat`を使用 - `xcode.XcodeWrite` -> `Write`ツールを使用 - `xcode.XcodeUpdate` -> `Edit`ツールを使用 - `xcode.XcodeGrep` -> `rg`または`grep`を使用 - `xcode.XcodeGlob` -> `find` / `glob`を使用 - `xcode.XcodeLS` -> `ls`コマンドを使用 - ファイル操作 -> 標準ツールを使用 --- ## トークン効率サマリー | 操作 | 最適な選択 | トークン影響 | |-----------|-------------|--------------| | クイック構文チェック | `mcporter call xcode.getDiagnostics` | 低 | | フルビルド | `mcporter call xcode.BuildProject` | 中 | | 特定のテストを実行 | `mcporter call xcode.RunSomeTests` | 中 | | すべてのテストを実行 | `mcporter call xcode.RunAllTests` | 高 | | ファイルを読む | `Read`ツール / `cat` | 低 | | ファイルを編集 | `Edit`ツール | 低 | | コードを検索 | `rg` / `grep` | 低 | | ファイルを一覧表示 | `ls` / `find` | 低 |