Xcode

Xcode

An MCP server enabling AI assistants to interact with Xcode projects and tools.

331
Stars
24
Forks
0
Releases

Overview

The Xcode MCP Server is an MCP (Model Context Protocol) implementation that provides comprehensive Xcode integration for AI assistants. It enables AI agents to interact with Xcode projects, manage iOS simulators, and perform a wide range of Xcode-related tasks with robust error handling and support for multiple project types. Core capabilities include project management (setting active projects, creating projects from templates, adding files with targets and groups, parsing workspaces, listing schemes), file operations (read/write with encodings, binary handling via base64, content search with patterns/regex, existence checks, metadata, and automatic directory creation), build and testing (building with configurable options, running tests with detailed failure reporting, code analysis, cleaning, and archiving), CocoaPods and Swift Package Manager integration (initialize, install/update/remove dependencies, add arbitrary commands, SPM package management and DocC documentation generation), and specialized iOS simulator and Xcode utilities (listing simulators, booting/shutting down, installing/launching apps, screenshots, performance tracing, asset catalogs, archive export/validation, and Xcode version switching). The server adheres to MCP, uses path validation and Zod-based parameter validation, and exposes a tool registry for organized access to capabilities. It is designed to work with standard projects, workspaces, and SPM-based workflows.

Details

Owner
r-huijts
Language
TypeScript
License
MIT License
Updated
2025-12-07

Features

Project Management

Set active projects, create projects from templates (iOS/macOS/watchOS/tvOS), add files with targets/groups, parse workspaces, and list schemes.

File Operations

Read/write files with encodings, handle binary data via base64, search with patterns/regex, check existence, fetch metadata, and auto-create directories.

Build & Testing

Build projects with configurable options, run tests with detailed failure reporting, perform code analysis, clean build artifacts, and archive for distribution.

CocoaPods Integration

Initialize CocoaPods, install/update pods, add/remove pod dependencies, and execute arbitrary pod commands.

Swift Package Manager

Initialize packages, add/remove/update dependencies with version constraints, resolve, generate DocC docs, and run tests/build.

iOS Simulator Tools

List simulators, boot/shutdown, install/launch apps, take screenshots, record videos, and manage simulator state.

Xcode Utilities

Execute xcrun commands, compile asset catalogs, generate app icon sets, trace performance, export/validate archives, and switch Xcode versions.

Audience

AI developersLeverage the MCP server to empower AI assistants to manage and interact with Xcode projects and related tooling.
iOS/macOS teamsAutomate project setup, file operations, builds, and workflows via MCP-powered AI agents.
DevOps teamsAutomate build, test, and archive processes within Xcode projects using MCP-enabled tooling.
Swift developersManage Swift Package Manager workflows and dependency changes through AI-assisted commands.

Tags

XcodeMCPAIXcode projectsiOS SimulatorCocoaPodsSwift Package ManagerProject ManagementFile OperationsBuild and TestingXcode Utilities