app-screen-mcp

Instructions

Implementation Reference

• src/index.ts:576-587 (handler)

  The 'bootSimulator' method handles the 'boot_simulator' tool request by executing 'xcrun simctl boot'.

  private async bootSimulator(udid: string) {
    try {
      await execAsync(`xcrun simctl boot ${udid}`);
    } catch (error: any) {
      if (!error.stderr?.includes('current state: Booted')) {
        throw new McpError(ErrorCode.InternalError, `Failed to boot simulator: ${error.message}`);
      }
    }
    return {
      content: [{ type: 'text', text: `Simulator ${udid} is booted.` }],
    };
  }

• src/index.ts:284-295 (registration)

  The 'boot_simulator' tool is registered in the list of available tools.

  {
    name: 'boot_simulator',
    description: 'Boot an iOS simulator by UDID',
    inputSchema: {
      type: 'object',
      properties: {
        udid: { type: 'string', description: 'Simulator UDID to boot' },
      },
      required: ['udid'],
      additionalProperties: false,
    },
  },

• src/index.ts:494-495 (handler)

  The 'boot_simulator' tool request is routed to the handler in the switch statement.

  case 'boot_simulator':
    return this.bootSimulator(args.udid as string);