
MobileBuildMCP
MCP server and CLI letting AI agents build, test and run iOS and macOS Xcode projects
The repository was last updated 3 days ago and is published under MIT.
- Pricing
- Open source
- Platforms
- macOS, CLI, self-hosted
- GitHub stars
- 6.6K
- Last commit
- 3 days ago
- Language
- TypeScript
- License
- MIT
Similar MCP servers
About MobileBuildMCP
MobileBuildMCP is an open-source MCP server for developer tools. It is available on macOS, CLI and self-hosted.
The README describes MobileBuildMCP as a Model Context Protocol server and command-line tool for working on Apple platform projects. It ships as one package, so the same tools can be driven by an AI coding agent over MCP or run directly from a terminal.
From the CLI, commands cover building for a simulator, preparing portable test products without running them, and running those prepared tests later on a chosen simulator. A per-workspace background daemon handles stateful operations such as log capture and debugging, starting automatically when needed.
The project targets developers who use AI coding assistants such as Cursor or Claude Code on macOS with Xcode installed. Device tools need code signing configured in Xcode, and the project notes it asks xcodebuild to skip Swift macro validation so macro-based projects build.
What it does
- Simulator build and test
- Builds Xcode projects for the iOS simulator and runs prepared test products from the command line.
- MCP server mode
- Runs as an MCP server so compatible AI coding clients can call its build and test tools.
- Terminal CLI
- Exposes the same tools through a mobilebuildmcp command for direct use outside an agent.
- Optional agent skills
- Offers MCP and CLI skills that prime an agent with instructions on using the tools.
- Stateful workspace daemon
- Uses a per-workspace daemon for operations such as log capture and debugging, started on demand.
- In-place upgrades
- Checks for newer versions and upgrades the installed CLI with a built-in command.
Good for
- Letting an AI coding agent build an iOS app and report compile errors
- Running Xcode test suites on a simulator from a script or CI-style terminal workflow
- Preparing test products once and rerunning them on different simulators
- Giving Cursor or Claude Code access to Xcode build tooling on macOS
Pricing
Open source
Free and MIT licensed; no paid plan mentioned.
MobileBuildMCP FAQ
What do I need to run it?
The README lists macOS 14.5 or later, Xcode 16.x or later, and Node.js 18.x or later unless installed via Homebrew.
How can it be installed?
Through Homebrew with a tap and brew install, or globally with npm. It can also run on demand with npx.
Do device tools work out of the box?
No. The README says device tools require code signing to be configured in Xcode.
Does it collect telemetry?
The README says it uses Sentry for internal runtime error telemetry only, with opt-out instructions in the privacy docs.
Is MobileBuildMCP free?
Yes. MobileBuildMCP is open source, so you can use and self-host it for free.
What are the best alternatives to MobileBuildMCP?
The closest alternatives to MobileBuildMCP are macbox, Codemagic MCP by usefulapi, adb-mcp: Android emulator and device control over adb, Mac YOLO Safeguards — Runaway Reaper & Token Budget MCP and Edit MCP.
Where this comes from
- Description: written from the project's README.