Xcode MCP Server
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
Usage with Claude Desktop
- Start the server:
- In Claude Desktop settings:
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:
run_tests
Runs unit tests with optional filtering.
Parameters:
projectPath(required): Path to the .xcodeproj or .xcworkspace
scheme(required): Test scheme name
testIdentifier(optional): Specific test to run (e.g., 'MyTests/testExample')
skipTests(optional): Array of test identifiers to skip
configuration(optional): Build configuration (Debug/Release, defaults to Debug)
destination(optional): Test destination (defaults to "platform=iOS Simulator,name=iPhone 15 Pro")
Example usage in Claude:
Logs
- All logs are stored in the specified base directory under
build-logs/
- Build operations create:
- Test operations create:
- Latest log (build or test) is accessible via the
xcode-build://latest-logresource
Xcode MCP Server
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
Usage with Claude Desktop
- Start the server:
- In Claude Desktop settings:
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:
run_tests
Runs unit tests with optional filtering.
Parameters:
projectPath(required): Path to the .xcodeproj or .xcworkspace
scheme(required): Test scheme name
testIdentifier(optional): Specific test to run (e.g., 'MyTests/testExample')
skipTests(optional): Array of test identifiers to skip
configuration(optional): Build configuration (Debug/Release, defaults to Debug)
destination(optional): Test destination (defaults to "platform=iOS Simulator,name=iPhone 15 Pro")
Example usage in Claude:
Logs
- All logs are stored in the specified base directory under
build-logs/
- Build operations create:
- Test operations create:
- Latest log (build or test) is accessible via the
xcode-build://latest-logresource