How cameroncooke/xcodebuildmcp works
MobileBuildMCP is a macOS developer-tool server and CLI for agents working on iOS and macOS projects. The main workflow is an agent or engineer invokes a CLI command or MCP tool, which runs project operations through Xcode and related executors and returns structured results. Its documented capabilities include builds and tests, simulator/device operations, UI automation, debugging, coverage, project discovery and scaffolding, Swift Package Manager, and Xcode IDE tool bridging. The graph combines documented capabilities with source-index relationships; several subsystem internals were not sampled.
Main entry points: server.ts MCP Server · tool-invoker.ts Tool Invoker · coverage Coverage · xcodebuild-pipeline.ts Xcodebuild Pipeline
Components 23
User Entry Points
- CLI
src/cli.ts - MCP Server
src/server/server.ts
Tool Runtime
- Tool Catalog
src/runtime/tool-catalog.ts - Tool Invoker
src/runtime/tool-invoker.ts - Typed Tool Factory
src/utils/typed-tool-factory.ts - Command and File Executors
src/utils/command.ts
Project Operations
- Build and Test
src/mcp/tools - Device and Simulator
src/mcp/tools - UI Automation
src/mcp/tools/ui-automation - Debugging
src/mcp/tools/debugging - Coverage
src/mcp/tools/coverage - Discovery and Scaffolding
src/mcp/tools - Swift Package Tools
src/mcp/tools/swift-package - Xcodebuild Pipeline
src/utils/xcodebuild-pipeline.ts
State and Integrations
- Configuration Store
src/utils/config-store.ts - Session Defaults Store
src/utils/session-store.ts - Xcode Tools Bridge
src/integrations/xcode-tools-bridge/manager.ts
Results and Support
- Domain Results and Fragments
src/types/domain-results.ts - Rendering
src/rendering/render.ts - Diagnostics
src/utils/diagnostics.ts - Logging
src/utils/logger.ts
Other components
- Engineer or Agent
- Xcode Toolchain
Connections 24
- Engineer or Agent → CLI: runs commands
README.md - Engineer or Agent → MCP Server: sends requests
README.md - CLI → Tool Catalog: lists tools
- MCP Server → Tool Catalog: exposes tools
README.md - Tool Catalog → Tool Invoker: dispatches calls
- Tool Invoker → Typed Tool Factory: invokes handlers
- Typed Tool Factory → Session Defaults Store: reads defaults
src/utils/typed-tool-factory.ts - MCP Server → Build and Test: offers build tools
README.md - MCP Server → Device and Simulator: offers device tools
README.md - MCP Server → UI Automation: offers automation
README.md - MCP Server → Debugging: offers debugging
README.md - MCP Server → Coverage: offers coverage
README.md - MCP Server → Discovery and Scaffolding: offers project tools
README.md - MCP Server → Swift Package Tools: offers package tools
README.md - Build and Test → Xcodebuild Pipeline: runs builds
- Coverage → Command and File Executors: executes commands
src/mcp/tools/coverage/get_file_coverage.ts - Xcodebuild Pipeline → Xcode Toolchain: runs operations
- Xcodebuild Pipeline → Domain Results and Fragments: emits fragments
src/utils/xcodebuild-pipeline.ts - Tool Invoker → Domain Results and Fragments: returns results
- Domain Results and Fragments → Rendering: renders output
- Coverage → Diagnostics: creates diagnostics
src/mcp/tools/coverage/get_file_coverage.ts - Xcode Tools Bridge → Xcode Toolchain: proxies tools
- Xcode Tools Bridge → Logging: logs failures
src/integrations/xcode-tools-bridge/manager.ts - Configuration Store → Session Defaults Store: uses defaults
src/utils/config-store.ts