XcodeBLOCK

A Model Context Protocol server for building Xcode projects directly from LLM applications

The Xcode MCP Server provides a Model Context Protocol interface for building and testing Xcode projects. It enables AI assistants to directly trigger builds, run tests, monitor progress, and access logs through a standardized interface.

Features

• Build Xcode projects with custom schemes and configurations
• Run unit tests with granular control (run specific tests or skip tests)
• Generate code coverage reports
• Stream build and test logs in real-time
• Access detailed build and test reports
• JSON-formatted output
• Automatic log persistence

Requirements

• Node.js 16+
• Xcode Command Line Tools
• TypeScript
• MCP-compatible client (e.g., Claude Desktop)

Installation

# Clone the repository
git clone https://github.com/PolarVista/Xcode-mcp-server.git
cd xcode-mcp-server

# Install dependencies
npm install

# Build the server
npm run build

Usage with Claude Desktop

1. Start the server:

npm run start /path/to/build/logs/directory

1. In Claude Desktop settings:

"command": "node",
"args": ["/path/to/the/xcode-mcp-server/build/index.js",
"/path/to/your/project/folder"],
"env": {
"PATH": "/usr/bin:/bin:/usr/local/bin:/usr/sbin:/sbin"
}

Available Tools

build_project

Builds an Xcode project with specified parameters.

Parameters:

• projectPath (required): Path to the .xcodeproj or .xcworkspace
• scheme (required): Build scheme name
• configuration (optional): Build configuration (Debug/Release, defaults to Debug)
• destination (optional): Build destination (defaults to "platform=iOS Simulator,name=iPhone 15 Pro")

Example usage in Claude:

build_project({
projectPath: "/path/to/Project.xcodeproj",
scheme: "MyApp",
configuration: