<objective> Documents the two MCP servers that power the Swift/Apple workflow: XcodeBuildMCP for Xcode project automation and build validation (discover projects, build for macOS/iOS Simulator/device, list schemes, clean builds, scaffold new projects, and autonomous build-fix-rebuild loops), and Apple Docs MCP for official documentation with offline WWDC access (all frameworks, symbol details, WWDC sessions 2014-2025 with transcripts, sample code, API availability/deprecation).

Defines the mandatory research-first priority order (Apple Docs MCP first, then Context7 for third-party libraries, then Exa web search) and the mandatory build-validation loop after every code change (build, read errors, fix, rebuild, only commit on zero errors).

Includes installation snippets for both servers and a quick-reference table mapping tasks to the right tool. </objective>

MCP Tools for Swift Development

Model Context Protocol servers for enhanced Swift/Xcode workflows.

Available MCP Servers

1. XcodeBuildMCP

Purpose: Xcode project automation and build validation

Documentation: xcode-build-mcp.md

Key features:

Discover Xcode projects and workspaces
Build for macOS, iOS Simulator, iOS Device
List schemes and show build settings
Clean builds and derived data
Create new projects from templates
Autonomous build validation (AI can build, read errors, fix, rebuild)

Installation:

{
  "mcpServers": {
    "XcodeBuildMCP": {
      "command": "npx",
      "args": ["-y", "xcodebuildmcp@latest"]
    }
  }
}

Use when:

After making code changes (MANDATORY validation)
Debugging build issues
Creating new Xcode projects
Cleaning stale builds

2. Apple Docs MCP

Purpose: Official Apple documentation with offline WWDC access

Documentation: apple-docs-mcp.md

Key features:

Search all Apple frameworks (SwiftUI, UIKit, Foundation, etc.)
Get detailed symbol information (classes, methods, properties)
WWDC sessions 2014-2025 with full transcripts (offline)
Access Apple sample code
Framework exploration and discovery
API availability and deprecation checking

Installation:

{
  "mcpServers": {
    "apple-docs": {
      "command": "npx",
      "args": ["-y", "@kimsungwhee/apple-docs-mcp"]
    }
  }
}

Use when:

Researching Apple APIs (PRIORITY over Context7)
Finding WWDC best practices
Checking API availability
Getting official code examples

Workflow Integration

Research-First (MANDATORY)

Priority order:
1. ⭐ Apple Docs MCP (official Apple docs + WWDC)
2. Context7 (third-party libraries)
3. Exa web search (community tutorials)

Build Validation (MANDATORY)

After EVERY code change:
1. XcodeBuildMCP: Build project
2. If errors → Read error messages
3. Fix issues
4. Rebuild to validate
5. Only commit if zero errors

Complete Development Workflow (2026)

1. Feature request received
   ↓
2. Apple Docs MCP: Search API/WWDC
   ↓
3. Read existing codebase (DRY principle)
   ↓
4. Implement following Apple patterns
   ↓
5. XcodeBuildMCP: Build to validate ⭐
   ↓
6. If build errors:
   - Read error messages
   - Fix issues
   - Rebuild
   ↓
7. Run tests (if available)
   ↓
8. Commit changes

Benefits

XcodeBuildMCP

✅ Autonomous error detection and fixing ✅ Zero tolerance for compilation errors ✅ Lightning-fast incremental builds ✅ Project scaffolding automation ✅ Build validation before commits

Apple Docs MCP

✅ Official Apple documentation (most accurate) ✅ WWDC sessions offline (2014-2025) ✅ Zero network latency ✅ Complete API coverage ✅ Deprecation and availability info

Resources

XcodeBuildMCP:

GitHub
npm
Version: 1.12.3

Apple Docs MCP:

GitHub
npm

Quick Reference

| Task | MCP Tool | Documentation | |------|----------|---------------| | Search Apple API | apple-docs | apple-docs-mcp.md | | Find WWDC session | apple-docs | apple-docs-mcp.md | | Get code example | apple-docs | apple-docs-mcp.md | | Build project | XcodeBuildMCP | xcode-build-mcp.md | | Validate changes | XcodeBuildMCP | xcode-build-mcp.md | | Clean build | XcodeBuildMCP | xcode-build-mcp.md | | Create project | XcodeBuildMCP | xcode-build-mcp.md |