article

README

xcodebuild MCP Server

A Model Context Protocol server that builds iOS workspace/project that enables seamless workflow working with iOS projects in Visual Studio Code using extensions like Cline or Roo Code.

Available Tools

build - Build iOS Xcode workspace/project
- folder (string, required): The full path of the current folder that the iOS Xcode workspace/project sits
test - Run test for iOS Xcode workspace/project
- folder (string, required): The full path of the current folder that the iOS Xcode workspace/project sits

Installation

Using uv (recommended)

When using uv no specific installation is needed. We will use uvx to directly run mcpxcodebuild.

Using PIP

Alternatively you can install mcpxcodebuild via pip:

pip install mcpxcodebuild

After installation, you can run it as a script using:

python -m  mcpxcodebuild

Configuration

Configure for Claude.app

Add to your Claude settings:

Using uvx

"mcpServers": {
  "mcpxcodebuild": {
    "command": "uvx",
    "args": ["mcpxcodebuild"]
  }
}

Using pip installation

"mcpServers": {
  "mcpxcodebuild": {
    "command": "python",
    "args": ["-m", "mcpxcodebuild"]
  }
}

License

xcodebuild MCP tool is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.

xcodebuild