Repolode
getsentry

getsentry/MobileBuildMCP

An MCP server and CLI that gives AI coding agents tools to build, test and run iOS and macOS Xcode projects.

Stars
6,494
Forks
328
Open issues
32
Last commit
6 hours ago

What is it?

MobileBuildMCP is a Model Context Protocol server and command-line tool for working with iOS and macOS projects. It wraps xcodebuild and related Apple tooling so that AI coding agents such as those in Cursor, Claude Code or Codex can build, test and run Xcode projects through structured tool calls instead of raw shell commands.

The same package works as a standalone CLI. Commands cover building for the simulator, preparing portable test products with build-for-testing and running them later, and listing available tools. A per-workspace daemon handles stateful operations such as log capture and debugging, starting automatically when needed.

Installation is available through Homebrew or npm, and the MCP server can be launched on demand with npx. It requires macOS 14.5 or later and Xcode 16.x or later.

Key features

  • 01Exposes Xcode build and test operations as MCP tools for AI agents.
  • 02Provides a CLI with commands for simulator builds and tests.
  • 03Can prepare test products with build-for-testing and run them separately.
  • 04Includes a per-workspace daemon for log capture and debugging.
  • 05Installs via Homebrew or npm and can run through npx without a global install.
  • 06Offers optional agent skills to prime MCP or CLI usage.

Use cases

  • Letting an AI coding agent build and fix an iOS app in Xcode.
  • Running simulator test suites from scripts or CI on macOS.
  • Splitting test-product preparation from test execution to reuse builds.
  • Driving Xcode projects from the terminal without opening the IDE.

Topics

FAQ

What is MobileBuildMCP?
An MCP server and CLI that gives AI coding agents tools to build, test and run iOS and macOS Xcode projects. MobileBuildMCP is a Model Context Protocol server and command-line tool for working with iOS and macOS projects. It wraps xcodebuild and related Apple tooling so that AI coding agents such as those in Cursor, Claude Code or Codex can build, test and run Xcode projects through structured tool calls instead of raw shell commands.
Is MobileBuildMCP free to use? What license does it have?
MobileBuildMCP is open source under the MIT license. Check the license terms before using it in commercial products.
Is MobileBuildMCP still maintained?
Actively maintained. The last commit to MobileBuildMCP was on Oct 20, 2026.
What can I use MobileBuildMCP for?
Letting an AI coding agent build and fix an iOS app in Xcode. Running simulator test suites from scripts or CI on macOS. Splitting test-product preparation from test execution to reuse builds. Driving Xcode projects from the terminal without opening the IDE.
Where can I get MobileBuildMCP?
The source code and installation instructions are on GitHub: https://github.com/getsentry/MobileBuildMCP

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects