xcodebuild

xcodebuild

What is xcodebuild?

xcodebuild is a Model Context Protocol (MCP) server designed to streamline iOS development workflows within Visual Studio Code. It enables the building of Xcode iOS workspaces or projects and provides feedback on errors to Large Language Models (LLMs).

How to use xcodebuild?

Installation can be done using uv (recommended) or pip.

• Using uv: No specific installation is needed. You can run it directly using uvx mcpxcodebuild.
• Using pip: Install via pip using pip install mcpxcodebuild. After installation, run it as a script using python -m mcpxcodebuild.

To configure it for Claude.app, add the following to your Claude settings:

• Using uvx:

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

• Using pip installation:

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

Key Features of xcodebuild

• Build iOS Projects: Supports building Xcode iOS workspaces or projects.
• Error Feedback to LLMs: Feeds build errors back to LLMs for analysis and potential solutions.
• VS Code Integration: Designed to work seamlessly with VS Code extensions like Cline or Roo Code for an enhanced iOS development experience.
• MCP Server: Functions as an MCP server, facilitating communication within the Model Context Protocol ecosystem.
• Available Tools:
  • build: Builds an iOS Xcode workspace/project. Requires the folder path.
  • test: Runs tests for an iOS Xcode workspace/project. Requires the folder path.

Use Cases of xcodebuild

• CI/CD Pipelines: Integrate into continuous integration and continuous delivery pipelines for automated iOS builds and error reporting.
• VS Code Development: Enhance the iOS development experience in VS Code by providing direct build and test capabilities with error feedback to AI assistants.
• Debugging: Quickly identify and diagnose build issues by leveraging LLMs for error analysis.

FAQ from xcodebuild

• How to install xcodebuild? You can install it using uv (recommended) or pip install mcpxcodebuild.
• How to configure xcodebuild for Claude.app? Add the provided JSON configuration to your Claude settings, choosing either the uvx or pip installation method.
• What are the available commands? The available commands are build and test, both requiring the folder path as an argument.
• What is the license for xcodebuild? xcodebuild is licensed under the MIT License.

License

xcodebuild MCP tool is licensed under the MIT License.

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:

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

"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.