XcodeBuildMCP

XcodeBuild MCP

A Model Context Protocol (MCP) server providing Xcode tools for AI assistants.

Overview

This project implements an MCP server exposing Xcode operations as tools for AI agents, enabling programmatic interaction with Xcode projects through a standardized interface, optimized for agent-driven development.

Why?

XcodeBuild MCP streamlines interaction between AI agents and Xcode projects by providing dedicated tools for common Xcode operations, removing reliance on manual command-line invocations. This enables AI agents to independently validate code changes by building projects, inspecting errors, and iterating autonomously.

Features

The XcodeBuildMCP server provides:

• Xcode project management: Build operations for macOS, iOS simulator, and iOS device targets; project information tools; clean operations.
• Simulator management: List, boot, and open iOS simulators; install and launch apps.
• App utilities: Extract bundle identifiers; launch apps on simulators and macOS.

Getting started

Prerequisites: Node.js, npm, Xcode command-line tools.

Installation: Clone, npm install, npm run build.

Adding to Windsurf/Cursor/Claude Desktop

Add a custom server configuration with the command pointing to the built index.js.

Debugging

Use MCP Inspector: npx @modelcontextprotocol/inspector node build/index.js.