Xcodebuild

MCP tool for building Xcode iOS workspace/project and feeding back error to LLMs.

python

80

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

This MCP server lets you build and test iOS Xcode projects directly from your MCP client, streamlining workflows with tools like Cline or Roo Code in your editor. It exposes two actions you can invoke on an iOS workspace to automate common tasks: building the project and running tests.

How to use

You will connect to this MCP server from your MCP client and choose one of the available actions against your iOS Xcode workspace. Use the build action to compile a workspace or project and the test action to execute tests. Both actions require you to provide the full path to the folder containing the iOS project. The server responds with results that you can use to drive your editor workflow, run extensions, and integrate with your CI or local development setup.

How to install

Prerequisites you need before installing and running the MCP server:

Python 3.x installed on your system if you plan to run via pip using the Python module.
A runtime tool for local MCP execution. You can use uv (recommended). If you prefer to run via Python, you will use uvx to execute the MCP server binary.

Install via uvx (recommended)

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

Install via Python (pip)

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

Available tools

build

Build an iOS Xcode workspace or project. Provide the full path to the folder containing the Xcode workspace/project.

test

Run tests for the iOS Xcode workspace/project. Provide the full folder path where the workspace/project resides.