PromptCC0 ยท prompts.chat
--- name: xcode-mcp description: Guidelines for efficient Xcode MCP tool usage. This skill should be used to understand when to use Xcode MCP tools vs standard tools. Xcode MCP consumes many tokens - use only for build, test, simulator, preview, and SourceKit diagnostics. Never use for file read/write/grep operations. --- # Xcode MCP Usage Guidelines Xcode MCP tools consume significant tokens. This skill defines when to use Xcode MCP and when to prefer standard tools. ## Complete Xcode MCP Tools Reference ### Window & Project Management | Tool | Description | Token Cost | |------|-------------|------------| | `mcp__xcode__XcodeListWindows` | List open Xcode windows (get tabIdentifier) | Low โ | ### Build Operations | Tool | Description | Token Cost | |------|-------------|------------| | `mcp__xcode__BuildProject` | Build the Xcode project | Medium โ | | `mcp__xcode__GetBuildLog` | Get build log with errors/warnings | Medium โ | | `mcp__xcode__XcodeListNavigatorIssues` | List issues in Issue Navigator | Low โ | ### Testing | Tool | Description | Token Cost | |------|-------------|------------| | `mcp__xcode__GetTestList` | Get available tests from test plan | Low โ | | `mcp__xcode__RunAllTests` | Run all tests | Medium | | `mcp__xcode__RunSomeTests` | Run specific tests (preferred) | Medium โ | ### Preview & Execution | Tool | Description | Token Cost | |------|-------------|------------| | `mcp__xcode__RenderPreview` | Render SwiftUI Preview snapshot | Medium โ | | `mcp__xcode__ExecuteSnippet` | Execute code snippet in file context | Medium โ | ### Diagnostics | Tool | Description | Token Cost | |------|-------------|------------| | `mcp__xcode__XcodeRefreshCodeIssuesInFile` | Get compiler diagnostics for specific file | Low โ | | `mcp__ide__getDiagnostics` | Get SourceKit diagnostics (all open files) | Low โ | ### Documentation | Tool | Description | Token Cost | |------|-------------|------------| | `mcp__xcode__DocumentationSearch` | Search Apple Developer Documentation | Low โ | ### File Operations (HIGH TOKEN - NEVER USE) | Tool | Alternative | Why | |------|-------------|-----| | `mcp__xcode__XcodeRead` | `Read` tool | High token consumption | | `mcp__xcode__XcodeWrite` | `Write` tool | High token consumption | | `mcp__xcode__XcodeUpdate` | `Edit` tool | High token consumption | | `mcp__xcode__XcodeGrep` | `rg` / `Grep` tool | High token consumption | | `mcp__xcode__XcodeGlob` | `Glob` tool | High token consumption | | `mcp__xcode__XcodeLS` | `ls` command | High token consumption | | `mcp__xcode__XcodeRM` | `rm` command | High token consumption | | `mcp__xcode__XcodeMakeDir` | `mkdir` command | High token consumption | | `mcp__xcode__XcodeMV` | `mv` command | High token consumption | --- ## Recommended Workflows ### 1. Code Change & Build Flow ``` 1. Search code โ rg "pattern" --type swift 2. Read file โ Read tool 3. Edit file โ Edit tool 4. Syntax check โ mcp__ide__getDiagnostics 5. Build โ mcp__xcode__BuildProject 6. Check errors โ mcp__xcode__GetBuildLog (if build fails) ``` ### 2. Test Writing & Running Flow ``` 1. Read test file โ Read tool 2. Write/edit test โ Edit tool 3. Get test list โ mcp__xcode__GetTestList 4. Run tests โ mcp__xcode__RunSomeTests (specific tests) 5. Check results โ Review test output ``` ### 3. SwiftUI Preview Flow ``` 1. Edit view โ Edit tool 2. Render preview โ mcp__xcode__RenderPreview 3. Iterate โ Repeat as needed ``` ### 4. Debug Flow ``` 1. Check diagnostics โ mcp__ide__getDiagnostics (quick syntax check) 2. Build project โ mcp__xcode__BuildProject 3. Get build log โ mcp__xcode__GetBuildLog (severity: error) 4. Fix issues โ Edit tool 5. Rebuild โ mcp__xcode__BuildProject ``` ### 5. Documentation Search ``` 1. Search docs โ mcp__xcode__DocumentationSearch 2. Review results โ Use information in implementation ``` --- ## Fallback Commands (When MCP Unavailable) If Xcode MCP is disconnected or unavailable, use these xcodebuild commands: ### Build Commands ```bash # Debug build (simulator) - replace <SchemeName> with your project's scheme xcodebuild -scheme <SchemeName> -configuration Debug -sdk iphonesimulator build # Release build (device) xcodebuild -scheme <SchemeName> -configuration Release -sdk iphoneos build # Build with workspace (for CocoaPods projects) xcodebuild -workspace <ProjectName>.xcworkspace -scheme <SchemeName> -configuration Debug -sdk iphonesimulator build # Build with project file xcodebuild -project <ProjectName>.xcodeproj -scheme <SchemeName> -configuration Debug -sdk iphonesimulator build # List available schemes xcodebuild -list ``` ### Test Commands ```bash # Run all tests xcodebuild test -scheme <SchemeName> -sdk iphonesimulator \ -destination "platform=iOS Simulator,name=iPhone 16" \ -configuration Debug # Run specific test class xcodebuild test -scheme <SchemeName> -sdk iphonesimulator \ -destination "platform=iOS Simulator,name=iPhone 16" \ -only-testing:<TestTarget>/<TestClassName> # Run specific test method xcodebuild test -scheme <SchemeName> -sdk iphonesimulator \ -destination "platform=iOS Simulator,name=iPhone 16" \ -only-testing:<TestTarget>/<TestClassName>/<testMethodName> # Run with code coverage xcodebuild test -scheme <SchemeName> -sdk iphonesimulator \ -configuration Debug -enableCodeCoverage YES # List available simulators xcrun simctl list devices available ``` ### Clean Build ```bash xcodebuild clean -scheme <SchemeName> ``` --- ## Quick Reference ### USE Xcode MCP For: - โ `BuildProject` - Building - โ `GetBuildLog` - Build errors - โ `RunSomeTests` - Running specific tests - โ `GetTestList` - Listing tests - โ `RenderPreview` - SwiftUI previews - โ `ExecuteSnippet` - Code execution - โ `DocumentationSearch` - Apple docs - โ `XcodeListWindows` - Get tabIdentifier - โ `mcp__ide__getDiagnostics` - SourceKit errors ### NEVER USE Xcode MCP For: - โ `XcodeRead` โ Use `Read` tool - โ `XcodeWrite` โ Use `Write` tool - โ `XcodeUpdate` โ Use `Edit` tool - โ `XcodeGrep` โ Use `rg` or `Grep` tool - โ `XcodeGlob` โ Use `Glob` tool - โ `XcodeLS` โ Use `ls` command - โ File operations โ Use standard tools --- ## Token Efficiency Summary | Operation | Best Choice | Token Impact | |-----------|-------------|--------------| | Quick syntax check | `mcp__ide__getDiagnostics` | ๐ข Low | | Full build | `mcp__xcode__BuildProject` | ๐ก Medium | | Run specific tests | `mcp__xcode__RunSomeTests` | ๐ก Medium | | Run all tests | `mcp__xcode__RunAllTests` | ๐ High | | Read file | `Read` tool | ๐ High | | Edit file | `Edit` tool | ๐ High| | Search code | `rg` / `Grep` | ๐ข Low | | List files | `ls` / `Glob` | ๐ข Low |
Credit
Related
All chat prompts ยท MCP how-to ยท Prompt Library





