mcpField
M
Mcpxcodebuild

Mcpxcodebuild

Local
github.com/ShenghaiWangDeveloper Tools85Updated 63w ago
Repository

About Mcpxcodebuild

mcpxcodebuild is an MCP server that builds iOS Xcode workspaces or projects and returns errors to an LLM. It is aimed at developers working on iOS projects in Visual Studio Code with extensions such as Cline or Roo Code.

Key features

  1. 01Build Xcode workspace or project
  2. 02Run tests for iOS projects
  3. 03Feed build errors back to the LLM

Use cases

  1. 01Building an iOS project from a VS Code AI extension
  2. 02Letting an LLM read build errors and fix code
  3. 03Running tests and reviewing failed results with an assistant

MCP support

This is an MCP server that exposes build and test tools to MCP clients, each taking the folder path of the Xcode project as a parameter.

#mcpxcodebuild#ios#xcode

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "xcodebuild": {
      "command": "uvx",
      "args": [
        "mcpxcodebuild"
      ]
    }
  }
}
Run commanduvx mcpxcodebuild

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
pypimcpxcodebuild

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project 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.

Trust Score mcpxcodebuild MCP server

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.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.