XcodeBuildMCP

Exposes 77 tools through both JSON-RPC-over-stdio MCP server interface and direct CLI invocation, with shared implementation logic in a unified codebase. Both modes use identical tool implementations via common entry point (build/cli.js) and the same configuration system (.xcodebuildmcp/config.yaml), enabling seamless switching between AI agent integration and human CLI usage without code duplication.

Organizes 77 tools into 15 logical workflow groups (simulator, device, macOS, build system, etc.) using a manifest-based discovery system that decouples tool definitions from invocation context. Tools are registered via YAML manifests that specify schemas, executors, and platform compatibility, enabling dynamic tool loading and context-aware filtering without hardcoded tool lists.

Manages session state and default values across tool invocations through a session management system that persists configuration in .xcodebuildmcp/config.yaml and session defaults. Enables agents to set defaults (e.g., preferred simulator, build configuration) once and reuse them across multiple tool calls without repetition.

Provides tools for managing Swift Package Manager (SPM) dependencies through package resolution, dependency graph analysis, and package update operations. Integrates with Xcode's SPM support to enable agents to add, remove, and update packages without manual Xcode interaction.

Provides tools for programmatic interaction with Xcode IDE through AppleScript/AXe framework integration, enabling agents to open projects, navigate code, and trigger IDE actions. Supports project file manipulation (adding files, modifying build settings) through Xcode project file parsing and generation.

Provides tools for generating new iOS/macOS projects from templates with configurable options (app name, bundle identifier, minimum deployment target, frameworks). Supports creating projects with pre-configured build settings, dependencies, and file structure to accelerate project setup.

Manages build artifacts (app bundles, frameworks, libraries) through artifact discovery, organization, and optional caching. Tracks artifact locations, sizes, and build metadata to enable efficient artifact reuse and cleanup. Supports artifact versioning and archival for build history tracking.

Analyzes build and test output to detect errors, warnings, and failures through pattern matching and heuristic analysis. Provides structured error reports with categorization (compilation error, linker error, test failure), location information, and suggested fixes. Integrates error detection across build, test, and deployment operations.

Provides comprehensive logging and observability through structured output formatting, environment-aware output adaptation, and integration with external logging services. Supports multiple output formats (JSON, plain text, structured logs) and log levels (debug, info, warning, error) for flexible integration with monitoring and debugging tools.

Provides comprehensive simulator control through a dedicated workflow that manages simulator boot/shutdown, device type selection, runtime installation, and state persistence. Implements simulator discovery via xcrun simctl, state tracking through session management, and coordinated lifecycle operations that handle simulator resource cleanup and error recovery.

Provides tools for building, signing, and deploying iOS apps to physical devices through a device-specific workflow that handles provisioning profile management, code signing, device discovery via xcrun instruments, and deployment orchestration. Integrates with Xcode's build system to generate signed IPA files and manages the deployment lifecycle from build to installation.

Provides a dedicated workflow for building, signing, and packaging macOS applications with support for code signing, notarization, and distribution formats (DMG, ZIP, App Store). Handles macOS-specific build configurations, entitlements management, and gatekeeper/notarization requirements for distribution.

Automatically discovers and analyzes Xcode projects and workspaces in the current directory and subdirectories, extracting project metadata (targets, schemes, build settings, dependencies) through xcodebuild introspection and project file parsing. Provides structured project information to agents for context-aware tool selection and build configuration.

Provides a high-level build abstraction (xcodemake) that wraps xcodebuild command invocation with intelligent parameter marshaling, build log parsing, error detection, and structured output formatting. Handles build configuration selection, scheme resolution, and platform-specific build flags while maintaining compatibility with raw xcodebuild for advanced use cases.

Executes unit tests, integration tests, and UI tests through xcodebuild test invocation with support for test filtering, parallel execution, and structured result parsing. Aggregates test results from multiple test targets, parses XCTest output, and provides structured test reports with pass/fail status, execution time, and failure details.

Collects and analyzes code coverage data from test execution through xcodebuild's coverage reporting, parsing coverage metrics (line coverage, branch coverage) and generating structured coverage reports. Integrates with test execution to provide coverage data alongside test results.

Provides tools for automating iOS/macOS UI interactions through XCUITest framework integration, enabling agents to script user interactions (tap, swipe, type), verify UI state, and capture screenshots. Supports UI element querying through accessibility identifiers and XPath-like selectors.