boot_sim
Boot an iOS simulator by specifying its UUID. Use this tool to activate a specific simulator for testing, ensuring the simulatorUuid parameter is provided.
Instructions
Boots an iOS simulator. IMPORTANT: You MUST provide the simulatorUuid parameter. Example: boot_sim({ simulatorUuid: 'YOUR_UUID_HERE' })
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| simulatorUuid | Yes | UUID of the simulator to use (obtained from list_simulators) |
Implementation Reference
- src/tools/simulator.ts:29-93 (handler)Full implementation of the boot_sim tool: registers the tool with schema, description, and handler that validates simulatorUuid, executes 'xcrun simctl boot', handles errors, and provides next steps.export function registerBootSimulatorTool(server: McpServer): void { server.tool( 'boot_sim', "Boots an iOS simulator. IMPORTANT: You MUST provide the simulatorUuid parameter. Example: boot_sim({ simulatorUuid: 'YOUR_UUID_HERE' })", { simulatorUuid: z .string() .describe('UUID of the simulator to use (obtained from list_simulators)'), }, async (params): Promise<ToolResponse> => { const simulatorUuidValidation = validateRequiredParam('simulatorUuid', params.simulatorUuid); if (!simulatorUuidValidation.isValid) { return simulatorUuidValidation.errorResponse!; } log('info', `Starting xcrun simctl boot request for simulator ${params.simulatorUuid}`); try { const command = ['xcrun', 'simctl', 'boot', params.simulatorUuid]; const result = await executeCommand(command, 'Boot Simulator'); if (!result.success) { return { content: [ { type: 'text', text: `Boot simulator operation failed: ${result.error}`, }, ], }; } return { content: [ { type: 'text', text: `Simulator booted successfully. Next steps: 1. Open the Simulator app: open_sim({ enabled: true }) 2. Install an app: install_app_sim({ simulatorUuid: "${params.simulatorUuid}", appPath: "PATH_TO_YOUR_APP" }) 3. Launch an app: launch_app_sim({ simulatorUuid: "${params.simulatorUuid}", bundleId: "YOUR_APP_BUNDLE_ID" }) 4. Log capture options: - Option 1: Capture structured logs only (app continues running): start_sim_log_cap({ simulatorUuid: "${params.simulatorUuid}", bundleId: "YOUR_APP_BUNDLE_ID" }) - Option 2: Capture both console and structured logs (app will restart): start_sim_log_cap({ simulatorUuid: "${params.simulatorUuid}", bundleId: "YOUR_APP_BUNDLE_ID", captureConsole: true }) - Option 3: Launch app with logs in one step: launch_app_logs_sim({ simulatorUuid: "${params.simulatorUuid}", bundleId: "YOUR_APP_BUNDLE_ID" })`, }, ], }; } catch (error) { const errorMessage = error instanceof Error ? error.message : String(error); log('error', `Error during boot simulator operation: ${errorMessage}`); return { content: [ { type: 'text', text: `Boot simulator operation failed: ${errorMessage}`, }, ], }; } }, ); }
- src/utils/register-tools.ts:324-327 (registration)Registration entry for the boot_sim tool in the central tool registry, conditionally enabled via environment variable.register: registerBootSimulatorTool, groups: [ToolGroup.SIMULATOR_MANAGEMENT, ToolGroup.IOS_SIMULATOR_WORKFLOW], envVar: 'XCODEBUILDMCP_TOOL_BOOT_SIMULATOR', },
- src/tools/simulator.ts:34-37 (schema)Zod schema for boot_sim input parameters.simulatorUuid: z .string() .describe('UUID of the simulator to use (obtained from list_simulators)'), },