You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
A comprehensive Model Context Protocol (MCP) server for iOS and macOS development. Provides 65 tools across 11 categories that give AI assistants full control over the Xcode development lifecycle — from building and testing to simulator management, app deployment, code signing, and more.
"Build my iOS app with the Debug configuration for the iPhone 16 simulator"
→ Uses xcode_build with scheme, configuration, and destination
"Run all unit tests for the MyApp scheme"
→ Uses xcode_test with the appropriate destination
"Run only the LoginTests test class, skip SlowTests"
→ Uses xcode_test with onlyTesting and skipTesting filters
Manage simulators
"List all available simulators"
→ Uses simulator_list to show all devices with their state
"Create a new iPhone 16 Pro simulator with iOS 18"
→ Uses simulator_list_device_types + simulator_list_runtimes to find IDs,
then simulator_create
"Boot the simulator and install my app"
→ Uses simulator_boot, then app_install with the .app path
Debug and capture
"Take a screenshot of the simulator"
→ Uses screenshot, returns the file path
"Record the simulator screen for 15 seconds"
→ Uses screen_record with duration=15
"Show me the last 5 minutes of logs for my app"
→ Uses log_collect with last="5m" and predicate filter
"Stream live logs from the simulator for 10 seconds"
→ Uses log_stream with timeout=10
App lifecycle
"Launch com.example.myapp on the booted simulator"
→ Uses app_launch with the bundle ID
"Grant camera permission to my app"
→ Uses app_privacy with action="grant", service="camera"
"Open a deep link: myapp://settings/profile"
→ Uses app_open_url with the custom URL scheme
"Where is my app's data stored?"
→ Uses app_get_container with container="data"
Environment simulation
"Set the simulator location to San Francisco"
→ Uses location_set with latitude=37.7749, longitude=-122.4194
"Send a test push notification with title 'Hello'"
→ Uses push_notification with APNs JSON payload
"Set the status bar to 9:41, full battery, full wifi"
→ Uses status_bar_override with time, batteryLevel, wifiBars
"Switch the simulator to dark mode"
→ Uses device_appearance with appearance="dark"
Code signing
"List all my code signing identities"
→ Uses signing_identities
"Show me all installed provisioning profiles"
→ Uses provisioning_profiles with summary for each
"Inspect the entitlements of my built app"
→ Uses entitlements_check on the .app bundle
Package management
"Resolve all SPM dependencies"
→ Uses spm_resolve
"Update my CocoaPods and check for outdated pods"
→ Uses pod_update then pod_outdated
"Show me the dependency tree for my Swift package"
→ Uses spm_show_dependencies with JSON format
Scaffolding
"Create a new SwiftUI iOS project called WeatherApp"
→ Uses project_create with template="swiftui", platform="ios"
"Generate a SwiftUI view called SettingsView with a preview"
→ Uses scaffold_view with includePreview=true
"Create a Core Data model called Task with title, isDone, and dueDate"
→ Uses scaffold_coredata_model with custom attributes
Analysis
"Analyze this IPA file — what's the bundle ID, size, and architectures?"
→ Uses ipa_analyze to unzip and inspect
"Check what privacy permissions this IPA requires"
→ Uses ipa_permissions to list NS*UsageDescription keys
"Verify that my dSYM file matches the release binary"
→ Uses dsym_verify to compare UUIDs
Prompt Cookbook
Ready-to-use prompts for common iOS development workflows:
Full build-test-deploy cycle
Build my project with the Release configuration, run all tests on an iPhone 16 Pro
simulator, and if tests pass, create an archive. Show me the test results.
Simulator setup from scratch
List available iOS runtimes, create a new iPhone 16 simulator with the latest iOS,
boot it, and open the Simulator app so I can see it.
Debug a crash
Stream the simulator logs for 30 seconds while I reproduce the crash.
Filter for error-level messages from my app's bundle ID com.myteam.myapp.
App Store screenshot preparation
Boot the simulator, set the status bar to 9:41 with full battery and full wifi
signal, set carrier name to an empty string, then take a screenshot.
CI/CD validation
Clean the project, build with Release configuration, run all tests,
check SwiftLint violations, and verify the binary size of the built product.
Dependency audit
Show me the full SPM dependency tree, then check if any CocoaPods are outdated.
Also run SwiftLint to check code quality.
New feature scaffolding
Create a SwiftUI view called ProfileView, a corresponding ProfileViewModel,
and a Core Data model called UserProfile with fields: id (UUID), name (String),
email (String), avatarURL (String), and lastLogin (Date).
Physical device deployment
List connected physical devices, install my built app on the first device,
launch it, and stream the device console logs for 20 seconds.
deviceId (req), time, batteryLevel, batteryState, wifiBars, cellularBars, operatorName, dataNetwork
status_bar_clear
Reset status bar to defaults
deviceId (req)
Push notification payload example
{
"aps": {
"alert": {
"title": "New Message",
"body": "You have a new message from John"
},
"badge": 1,
"sound": "default"
},
"customKey": "customValue"
}
Response truncation — long outputs are truncated using head+tail (start and end) to preserve both log boundaries; 100KB cap on success and error output
Timeout management — configurable per-tool with optional timeoutSeconds param; defaults vary by operation
No Xcode required at install — environment detection happens at runtime; graceful guidance when tools unavailable
Development
Setup
git clone https://github.com/sitharaj88/xcode-pilot-mcp.git
cd xcode-pilot-mcp
npm install
Build
npm run build # Compile TypeScript + copy templates + chmod +x
npm run dev # Watch mode (tsc --watch)
Test
npm test# Run all tests
npm run test:coverage # Run with coverage report
Code Quality
npm run lint # ESLint
npm run lint:fix # ESLint with auto-fix
npm run format # Prettier write
npm run format:check # Prettier check only
npm run typecheck # TypeScript --noEmit
npm run check # All of the above
Scripts Reference
Script
Description
build
Compile TS, copy templates, make executable
dev
TypeScript watch mode
test
Run vitest
test:coverage
Run vitest with V8 coverage
lint
ESLint check
lint:fix
ESLint auto-fix
format
Prettier write
format:check
Prettier check
typecheck
TypeScript type check
check
typecheck + lint + format:check
prepare
Husky git hooks setup
prepublishOnly
Full quality gate before npm publish
Contributing
See CONTRIBUTING.md for development setup, coding standards, and PR guidelines.
