Build and Test iOS Projects in Xcode
xcodebuild MCP Server lets AI assistants build and test iOS Xcode workspaces directly from VS Code extensions.
Why it matters
Streamline your iOS development by automating builds and tests directly from Visual Studio Code. This MCP connector integrates seamlessly with Xcode, providing enhanced debugging capabilities through error forwarding to LLMs.
Outcomes
What it gets done
Build iOS Xcode workspaces and projects
Run tests for iOS Xcode projects
Forward build/test errors to LLM for debugging
Integrate with VS Code extensions like Cline and Roo Code
Install
Add it to your toolbox
Run in your project directory:
curl -fsSL https://spark.entire.vc/get/vb-xcodebuild | bash Capabilities
Tools your agent gets
Build iOS Xcode workspace/project
Run tests for iOS Xcode workspace/project
Overview
xcodebuild MCP Server
xcodebuild MCP Server exposes just two Xcode operations, build and test, as MCP tools so an AI assistant in VS Code can compile and test an iOS project without leaving the editor. Use it for a minimal build/test workflow inside VS Code with Cline or Roo Code; use a fuller Xcode MCP server for project creation, dependencies, or simulator control.
What it does
xcodebuild MCP Server is a lightweight Model Context Protocol server that builds and tests iOS Xcode workspaces or projects, designed for a seamless workflow when working on iOS projects in Visual Studio Code with extensions like Cline or Roo Code. It wraps the two most essential Xcode command-line operations - build and test - as MCP tools an AI assistant can call directly.
When to use - and when NOT to
Use this when you're editing an iOS project in VS Code with an AI coding extension and want the assistant to build or test the project without switching to Xcode or a terminal. It's intentionally minimal - just build and test - rather than a full Xcode automation suite. It is not useful for project scaffolding, dependency management, simulator control, or other Xcode tasks - for those, a more comprehensive Xcode MCP server would be needed instead.
Capabilities
build: builds the iOS Xcode workspace/project located at a given folder path.test: runs tests for the iOS Xcode workspace/project located at a given folder path.
How to install
With uv, no installation is needed - run directly via uvx. Or install via pip:
pip install mcpxcodebuild
python -m mcpxcodebuild
For Claude, add to your settings:
"mcpServers": {
"mcpxcodebuild": {
"command": "uvx",
"args": ["mcpxcodebuild"]
}
}
Or, if installed via pip, use command: python, args ["-m", "mcpxcodebuild"].
Who it's for
iOS developers working in VS Code with AI coding extensions like Cline or Roo Code who want a simple way to trigger Xcode builds and tests directly from the editor, without a full-featured Xcode automation tool.
Source 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/projectfolder(string, required): The full path of the current folder that the iOS Xcode workspace/project sits
test- Run test for iOS Xcode workspace/projectfolder(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"]
}
}
FAQ
Common questions
Discussion
Questions & comments · 0
Sign In Sign in to leave a comment.