Xcode-mcp-server

Xcode-mcp-server

An MCP server enabling AI assistants to control Xcode for Apple development.

2
Stars
0
Forks
0
Releases

Overview

Xcode MCP Server is an MCP (Model Context Protocol) server that enables AI assistants such as Claude or Cursor to interact with Xcode and Apple platform development directly. It supports discovering and navigating Xcode projects and source files, building and running apps across iOS, macOS, tvOS, and watchOS, and executing tests with detailed results. It can retrieve and present build errors and warnings, capture console output from running applications, and take screenshots of Xcode windows and iOS simulators. It also provides management of simulators and visibility into their status. The server emphasizes security by implementing path-based access control, allowing you to restrict accessible folders with XCODEMCP_ALLOWED_FOLDERS and requiring absolute, existing directory paths. The project notes that it is built with FastMCP and uses AppleScript to communicate with Xcode. Setup requires macOS, Xcode, and Python 3.8+, and can be wired up via Claude Code, Claude Desktop, or Cursor AI clients. It supports CLI options and per-client env settings for access control.

Details

Owner
drewster99
Language
Python
License
MIT License
Updated
2025-12-07

Features

Discover and navigate Xcode projects and files

AI assistants can locate projects, browse directories, and identify relevant Xcode artifacts to work with.

Build and run on Apple platforms

Build and run iOS, macOS, tvOS, and watchOS apps from MCP clients.

Execute and monitor tests

Run tests with detailed results, including failures and pass status, to verify changes.

Debug build failures

Retrieve build errors and warnings to help diagnose issues quickly.

Capture console output

Capture and relay console logs from running applications for troubleshooting.

Take screenshots

Capture screenshots of Xcode windows and iOS simulators for reporting.

Manage simulators

Manage simulators and view their status to streamline testing.

Security and access control

Path-based access control restricts folders via XCODEMCP_ALLOWED_FOLDERS for safer operation.

Audience

MCP clientsIntegrate Claude, Cursor, or other MCP clients to control Xcode projects.
Xcode developersUse AI-assisted tools to browse, build, and debug within Xcode projects.
Apple platform developersEnable AI-driven automation for building and testing Apple platform apps.

Tags

XcodemacOSMCPAI assistantsbuildtestsdebugscreenshotssimulatorsApple platforms