XC

xcodebuild

Created 6 months ago

A Model Context Protocol server that builds iOS workspace/project for Visual Studio Code.

development documentation public

What is xcodebuild?

🍎 Build iOS Xcode workspace/project and feed back errors to llm.

Documentation

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.

Server Config

{
  "mcpServers": {
    "xcodebuild-server": {
      "command": "npx",
      "args": [
        "xcodebuild"
      ]
    }
  }
}

Links & Status

Repository: github.com
Hosted: No
Global: No
Official: Yes

Project Info

Hosted Featured
Created At: May 23, 2025
Updated At: Aug 07, 2025
Author: Shenghai Wang
Category: community
License: MIT License
Tags:
development documentation public