Xcode Development Skill

This skill provides guidance for using xc-mcp tools efficiently based on the task at hand. It routes operations to the appropriate MCP server or native CLI to minimize token overhead.

Server Architecture

The xc-mcp toolset is split into focused servers for token efficiency:

Routing Guidelines

Project File Manipulation → xc-project MCP

Use mcpxc-project* tools for operations that modify .xcodeproj files:

• Adding/removing files, targets, groups
• Modifying build settings
• Managing Swift packages
• Adding frameworks and dependencies

These operations require the XcodeProj library - no CLI equivalent exists.

iOS Simulator Operations → xc-simulator MCP

Use mcpxc-simulator* tools for:

• Build and run workflows (buildrunsim)
• Simulator management (boot, list, erase)
• UI automation (tap, swipe, type text)
• Screenshot capture
• App installation and launch

Physical Device Operations → xc-device MCP

Use mcpxc-device* tools for:

• Building for devices
• Installing and launching apps on devices
• Device log capture

Debug Sessions → xc-debug MCP

Use mcpxc-debug* tools for:

• Attaching to running processes
• Setting/removing breakpoints
• Inspecting variables and stack
• Executing LLDB commands

Debug sessions maintain persistent state - use this server for multi-step debugging workflows.

Swift Packages → xc-swift MCP

Use mcpxc-swift* tools for:

• Building Swift packages
• Running tests
• Executing package binaries

macOS & Discovery → xc-build MCP

Use mcpxc-build* tools for:

• macOS application builds
• Project/scheme discovery
• Build settings queries
• Project scaffolding
• Clean operations

Simple Queries → Bash (Direct CLI)

For read-only queries, use Bash directly to avoid MCP overhead:

# List schemes
xcodebuild -list -json

# List simulators
xcrun simctl list devices --json

# Simple SPM build
swift build

Configuration Presets

Users can configure which servers to enable in their .mcp.json:

Minimal (project editing only) - ~5K tokens

{
  "mcpServers": {
    "xc-project": { "command": "xc-project" }
  }
}

Standard (build + project) - ~14K tokens

{
  "mcpServers": {
    "xc-project": { "command": "xc-project" },
    "xc-build": { "command": "xc-build" },
    "xc-simulator": { "command": "xc-simulator" }
  }
}

Full (all capabilities) - ~20K tokens

{
  "mcpServers": {
    "xc-project": { "command": "xc-project" },
    "xc-build": { "command": "xc-build" },
    "xc-simulator": { "command": "xc-simulator" },
    "xc-device": { "command": "xc-device" },
    "xc-debug": { "command": "xc-debug" },
    "xc-swift": { "command": "xc-swift" }
  }
}

Monolithic (all tools, single server) - ~50K tokens

{
  "mcpServers": {
    "xc-mcp": { "command": "xc-mcp" }
  }
}

Decision Matrix

Fallback Behavior

If no MCP server is configured for a capability:

1. Attempt to use native CLI via Bash
2. For project file edits: suggest using xcodegen with spec files
3. Inform user about available MCP servers for better experience