A Model Context Protocol (MCP) server that provides Xcode-related tools for integration with AI assistants and other MCP clients.

This project implements an MCP server that exposes Xcode operations as tools that can be invoked by MCP clients. It allows AI assistants or other tools to interact with Xcode projects programmatically through a standardised interface.

The XcodeBuildMCP server provides the following tools:

- **build**: Builds the project using xcodebuild with support for workspaces, projects, schemes, and various platforms (iOS, macOS, watchOS, tvOS, visionOS and their simulator variants).

- **showBuildSettings**: Shows build settings for the project using xcodebuild.

- **getAppPath**: Extracts the app bundle path from build settings, making it easier to find the built app for installation or launching.

- **listSchemes**: Lists all available schemes in an Xcode project or workspace.

- **clean**: Cleans build products using xcodebuild's native clean action.

- **listSimulators**: Lists available iOS simulators with their UUIDs.

- **bootSimulator**: Boots an iOS simulator using a specified UUID.

- **openSimulator**: Opens the iOS Simulator app to view the simulator UI.

- **installAppInSimulator**: Installs an app in an iOS simulator.

- **launchAppInSimulator**: Launches an app in an iOS simulator using its bundle ID.

- **launchMacOSApp**: Launches a macOS app using the open command.

- **getBundleId**: Extracts the bundle identifier from an app bundle (.app).

- **getiOSBundleId**: Extracts the bundle identifier from an iOS app bundle.

- **getMacOSBundleId**: Extracts the bundle identifier from a macOS app bundle.

- Node.js (v16 or later)

- npm

- Xcode command-line tools

1. Clone the repository

2. Install dependencies:

```

```

3. Build the project:

```

```

4. Optionally start the server:

```

```

Create a new custom server configuration and add the following; changing the path to the actual path you cloned the repo to.

{

"mcpServers": {

"XcodeBuildMCP": {

"command": "node",

"args": [

"/path_to/XcodeBuildMCP/build/index.js"

]

}

}

}

You can use MCP Inspector via:

npx @modelcontextprotocol/inspector node build/index.js

This project is licensed under the MIT License - see the LICENSE file for details.