@ebowwa/mcp-ios-devices 1.0.0

package/src/tools/process.ts

@@ -0,0 +1,109 @@
+/**
+ * Process Management Tools
+ * List, launch, terminate, and signal processes on iOS devices
+ */
+
+import { z } from 'zod';
+import { registerTool } from '../registry.js';
+import { DeviceCtl } from '@ebowwa/ios-devices';
+
+const deviceCtl = new DeviceCtl();
+
+registerTool({
+  name: 'ios_list_processes',
+  description: 'List all running processes on a device',
+  inputSchema: z.object({
+    deviceId: z.string().describe('Device UDID'),
+  }),
+  handler: async ({ deviceId }) => {
+    return deviceCtl.listProcesses(deviceId);
+  },
+});
+
+registerTool({
+  name: 'ios_launch_app',
+  description: 'Launch an app on the device',
+  inputSchema: z.object({
+    deviceId: z.string().describe('Device UDID'),
+    bundleId: z.string().describe('App bundle identifier (e.g., com.apple.MobileSMS)'),
+    arguments: z.array(z.string()).optional().describe('Arguments to pass to the app'),
+    environment: z.record(z.string()).optional().describe('Environment variables'),
+  }),
+  handler: async ({ deviceId, bundleId, arguments: args, environment }) => {
+    return deviceCtl.launchApp(deviceId, bundleId, { arguments: args, environment });
+  },
+});
+
+registerTool({
+  name: 'ios_terminate_process',
+  description: 'Terminate a process by PID or name',
+  inputSchema: z.object({
+    deviceId: z.string().describe('Device UDID'),
+    process: z.union([z.number(), z.string()]).describe('Process PID (number) or name (string)'),
+  }),
+  handler: async ({ deviceId, process }) => {
+    return deviceCtl.terminateProcess(deviceId, process);
+  },
+});
+
+registerTool({
+  name: 'ios_signal_process',
+  description: 'Send a signal to a process',
+  inputSchema: z.object({
+    deviceId: z.string().describe('Device UDID'),
+    pid: z.number().describe('Process ID'),
+    signal: z.enum(['SIGTERM', 'SIGKILL', 'SIGHUP', 'SIGINT', 'SIGSTOP', 'SIGCONT', 'SIGUSR1', 'SIGUSR2']),
+  }),
+  handler: async ({ deviceId, pid, signal }) => {
+    return deviceCtl.signalProcess(deviceId, pid, signal);
+  },
+});
+
+registerTool({
+  name: 'ios_suspend_process',
+  description: 'Suspend a running process',
+  inputSchema: z.object({
+    deviceId: z.string().describe('Device UDID'),
+    pid: z.number().describe('Process ID'),
+  }),
+  handler: async ({ deviceId, pid }) => {
+    return deviceCtl.suspendProcess(deviceId, pid);
+  },
+});
+
+registerTool({
+  name: 'ios_resume_process',
+  description: 'Resume a suspended process',
+  inputSchema: z.object({
+    deviceId: z.string().describe('Device UDID'),
+    pid: z.number().describe('Process ID'),
+  }),
+  handler: async ({ deviceId, pid }) => {
+    return deviceCtl.resumeProcess(deviceId, pid);
+  },
+});
+
+registerTool({
+  name: 'ios_send_memory_warning',
+  description: 'Send a memory warning to a process',
+  inputSchema: z.object({
+    deviceId: z.string().describe('Device UDID'),
+    pid: z.number().describe('Process ID'),
+  }),
+  handler: async ({ deviceId, pid }) => {
+    return deviceCtl.sendMemoryWarning(deviceId, pid);
+  },
+});
+
+registerTool({
+  name: 'ios_post_notification',
+  description: 'Post a Darwin notification to the device',
+  inputSchema: z.object({
+    deviceId: z.string().describe('Device UDID'),
+    name: z.string().describe('Notification name'),
+    userInfo: z.record(z.any()).optional().describe('Optional user info dictionary'),
+  }),
+  handler: async ({ deviceId, name, userInfo }) => {
+    return deviceCtl.postNotification(deviceId, name, userInfo);
+  },
+});

package/src/tools/profile.ts

@@ -0,0 +1,56 @@
+/**
+ * Provisioning Profile Tools
+ * Manage provisioning profiles on devices
+ */
+
+import { z } from 'zod';
+import { registerTool } from '../registry.js';
+import { LibIMobileDevice } from '@ebowwa/ios-devices';
+
+registerTool({
+  name: 'ios_list_profiles',
+  description: 'List installed provisioning profiles',
+  inputSchema: z.object({
+    deviceId: z.string().describe('Device UDID'),
+  }),
+  handler: async ({ deviceId }) => {
+    const lib = new LibIMobileDevice({ udid: deviceId });
+    return lib.listProfiles();
+  },
+});
+
+registerTool({
+  name: 'ios_install_profile',
+  description: 'Install a provisioning profile',
+  inputSchema: z.object({
+    deviceId: z.string().describe('Device UDID'),
+    profilePath: z.string().describe('Path to .mobileprovision file'),
+  }),
+  handler: async ({ deviceId, profilePath }) => {
+    const lib = new LibIMobileDevice({ udid: deviceId });
+    return lib.installProfile(profilePath);
+  },
+});
+
+registerTool({
+  name: 'ios_remove_profile',
+  description: 'Remove a provisioning profile',
+  inputSchema: z.object({
+    deviceId: z.string().describe('Device UDID'),
+    uuid: z.string().describe('Profile UUID'),
+  }),
+  handler: async ({ deviceId, uuid }) => {
+    const lib = new LibIMobileDevice({ udid: deviceId });
+    return lib.removeProfile(uuid);
+  },
+});
+
+registerTool({
+  name: 'ios_list_dev_mode',
+  description: 'List developer mode status for devices',
+  inputSchema: z.object({}),
+  handler: async () => {
+    const lib = new LibIMobileDevice();
+    return lib.listDevMode();
+  },
+});

package/src/tools/screenshot.ts

@@ -0,0 +1,21 @@
+/**
+ * Screenshot Tools
+ * Capture screenshots from devices
+ */
+
+import { z } from 'zod';
+import { registerTool } from '../registry.js';
+import { LibIMobileDevice } from '@ebowwa/ios-devices';
+
+registerTool({
+  name: 'ios_screenshot',
+  description: 'Take a screenshot of the device screen',
+  inputSchema: z.object({
+    deviceId: z.string().describe('Device UDID'),
+    outputPath: z.string().optional().describe('Output file path (.tiff)'),
+  }),
+  handler: async ({ deviceId, outputPath }) => {
+    const lib = new LibIMobileDevice({ udid: deviceId });
+    return lib.takeScreenshot(outputPath);
+  },
+});

package/src/tools/simulator.ts

@@ -0,0 +1,497 @@
+/**
+ * Simulator Tools
+ * Control iOS Simulator via simctl
+ */
+
+import { z } from 'zod';
+import { registerTool } from '../registry.js';
+import { SimCtl } from '@ebowwa/ios-devices';
+
+const simCtl = new SimCtl();
+
+// ============================================================================
+// Device Management
+// ============================================================================
+
+registerTool({
+  name: 'sim_list',
+  description: 'List simulators, device types, or runtimes',
+  inputSchema: z.object({
+    devices: z.boolean().optional().describe('List devices'),
+    deviceTypes: z.boolean().optional().describe('List device types'),
+    runtimes: z.boolean().optional().describe('List runtimes'),
+    available: z.boolean().optional().describe('Only available'),
+    search: z.string().optional().describe('Search term'),
+  }),
+  handler: async (options) => {
+    return simCtl.list(options);
+  },
+});
+
+registerTool({
+  name: 'sim_create',
+  description: 'Create a new simulator',
+  inputSchema: z.object({
+    name: z.string().describe('Simulator name'),
+    deviceTypeId: z.string().describe('Device type (e.g., com.apple.CoreSimulator.SimDeviceType.iPhone-16)'),
+    runtimeId: z.string().describe('Runtime (e.g., com.apple.CoreSimulator.SimRuntime.iOS-18-1)'),
+  }),
+  handler: async ({ name, deviceTypeId, runtimeId }) => {
+    return simCtl.create(name, deviceTypeId, runtimeId);
+  },
+});
+
+registerTool({
+  name: 'sim_clone',
+  description: 'Clone an existing simulator',
+  inputSchema: z.object({
+    udid: z.string().describe('Source simulator UDID'),
+    name: z.string().describe('Name for cloned simulator'),
+  }),
+  handler: async ({ udid, name }) => {
+    return simCtl.clone(udid, name);
+  },
+});
+
+registerTool({
+  name: 'sim_delete',
+  description: 'Delete one or more simulators',
+  inputSchema: z.object({
+    udids: z.union([z.string(), z.array(z.string())]).describe('Simulator UDID(s) to delete'),
+  }),
+  handler: async ({ udids }) => {
+    return simCtl.delete(udids);
+  },
+});
+
+registerTool({
+  name: 'sim_delete_unavailable',
+  description: 'Delete all unavailable simulators',
+  inputSchema: z.object({}),
+  handler: async () => {
+    return simCtl.deleteUnavailable();
+  },
+});
+
+registerTool({
+  name: 'sim_erase',
+  description: 'Erase a simulator (reset to factory state)',
+  inputSchema: z.object({
+    udid: z.string().describe('Simulator UDID'),
+  }),
+  handler: async ({ udid }) => {
+    return simCtl.erase(udid);
+  },
+});
+
+registerTool({
+  name: 'sim_rename',
+  description: 'Rename a simulator',
+  inputSchema: z.object({
+    udid: z.string().describe('Simulator UDID'),
+    name: z.string().describe('New name'),
+  }),
+  handler: async ({ udid, name }) => {
+    return simCtl.rename(udid, name);
+  },
+});
+
+// ============================================================================
+// Boot/Shutdown
+// ============================================================================
+
+registerTool({
+  name: 'sim_boot',
+  description: 'Boot a simulator',
+  inputSchema: z.object({
+    udid: z.string().describe('Simulator UDID (or "booted" for any booted)'),
+  }),
+  handler: async ({ udid }) => {
+    return simCtl.boot(udid);
+  },
+});
+
+registerTool({
+  name: 'sim_shutdown',
+  description: 'Shutdown a simulator',
+  inputSchema: z.object({
+    udid: z.string().describe('Simulator UDID'),
+  }),
+  handler: async ({ udid }) => {
+    return simCtl.shutdown(udid);
+  },
+});
+
+registerTool({
+  name: 'sim_shutdown_all',
+  description: 'Shutdown all simulators',
+  inputSchema: z.object({}),
+  handler: async () => {
+    return simCtl.shutdownAll();
+  },
+});
+
+// ============================================================================
+// App Management
+// ============================================================================
+
+registerTool({
+  name: 'sim_install',
+  description: 'Install an app on a simulator',
+  inputSchema: z.object({
+    udid: z.string().describe('Simulator UDID'),
+    appPath: z.string().describe('Path to .app bundle'),
+  }),
+  handler: async ({ udid, appPath }) => {
+    return simCtl.install(udid, appPath);
+  },
+});
+
+registerTool({
+  name: 'sim_uninstall',
+  description: 'Uninstall an app from a simulator',
+  inputSchema: z.object({
+    udid: z.string().describe('Simulator UDID'),
+    bundleId: z.string().describe('App bundle identifier'),
+  }),
+  handler: async ({ udid, bundleId }) => {
+    return simCtl.uninstall(udid, bundleId);
+  },
+});
+
+registerTool({
+  name: 'sim_get_app_container',
+  description: 'Get the path to an app container',
+  inputSchema: z.object({
+    udid: z.string().describe('Simulator UDID'),
+    bundleId: z.string().describe('App bundle identifier'),
+    containerType: z.string().optional().describe('Container type (app, data, groups, etc.)'),
+  }),
+  handler: async ({ udid, bundleId, containerType }) => {
+    return simCtl.getAppContainer(udid, bundleId, containerType);
+  },
+});
+
+// ============================================================================
+// App Execution
+// ============================================================================
+
+registerTool({
+  name: 'sim_launch',
+  description: 'Launch an app on a simulator',
+  inputSchema: z.object({
+    udid: z.string().describe('Simulator UDID'),
+    bundleId: z.string().describe('App bundle identifier'),
+    waitForDebugger: z.boolean().optional().describe('Wait for debugger to attach'),
+    console: z.boolean().optional().describe('Show console output'),
+    env: z.record(z.string()).optional().describe('Environment variables'),
+    args: z.array(z.string()).optional().describe('Arguments'),
+  }),
+  handler: async ({ udid, bundleId, waitForDebugger, console, env, args }) => {
+    return simCtl.launch(udid, bundleId, { waitForDebugger, console, env, args });
+  },
+});
+
+registerTool({
+  name: 'sim_terminate',
+  description: 'Terminate an app on a simulator',
+  inputSchema: z.object({
+    udid: z.string().describe('Simulator UDID'),
+    bundleId: z.string().describe('App bundle identifier'),
+  }),
+  handler: async ({ udid, bundleId }) => {
+    return simCtl.terminate(udid, bundleId);
+  },
+});
+
+registerTool({
+  name: 'sim_spawn',
+  description: 'Spawn a process on a simulator',
+  inputSchema: z.object({
+    udid: z.string().describe('Simulator UDID'),
+    executable: z.string().describe('Executable path'),
+    args: z.array(z.string()).optional().describe('Arguments'),
+  }),
+  handler: async ({ udid, executable, args }) => {
+    return simCtl.spawn(udid, executable, args);
+  },
+});
+
+// ============================================================================
+// IO Operations
+// ============================================================================
+
+registerTool({
+  name: 'sim_screenshot',
+  description: 'Take a screenshot of a simulator',
+  inputSchema: z.object({
+    udid: z.string().describe('Simulator UDID'),
+    outputPath: z.string().describe('Output file path'),
+    type: z.enum(['png', 'jpeg', 'tiff']).optional().default('png'),
+  }),
+  handler: async ({ udid, outputPath, type }) => {
+    return simCtl.screenshot(udid, outputPath, { type });
+  },
+});
+
+registerTool({
+  name: 'sim_record_video',
+  description: 'Record video of a simulator',
+  inputSchema: z.object({
+    udid: z.string().describe('Simulator UDID'),
+    outputPath: z.string().describe('Output file path (.mp4)'),
+    codec: z.enum(['h264', 'hevc']).optional(),
+  }),
+  handler: async ({ udid, outputPath, codec }) => {
+    return simCtl.recordVideo(udid, outputPath, { codec });
+  },
+});
+
+// ============================================================================
+// Location
+// ============================================================================
+
+registerTool({
+  name: 'sim_set_location',
+  description: 'Set simulated location on a simulator',
+  inputSchema: z.object({
+    udid: z.string().describe('Simulator UDID'),
+    latitude: z.number().describe('Latitude'),
+    longitude: z.number().describe('Longitude'),
+  }),
+  handler: async ({ udid, latitude, longitude }) => {
+    return simCtl.setLocation(udid, latitude, longitude);
+  },
+});
+
+registerTool({
+  name: 'sim_reset_location',
+  description: 'Reset simulated location',
+  inputSchema: z.object({
+    udid: z.string().describe('Simulator UDID'),
+  }),
+  handler: async ({ udid }) => {
+    return simCtl.resetLocation(udid);
+  },
+});
+
+// ============================================================================
+// Status Bar
+// ============================================================================
+
+registerTool({
+  name: 'sim_status_bar_override',
+  description: 'Override status bar appearance',
+  inputSchema: z.object({
+    udid: z.string().describe('Simulator UDID'),
+    time: z.string().optional().describe('Time (e.g., "9:41")'),
+    dataNetwork: z.string().optional().describe('Data network type'),
+    wifiMode: z.enum(['active', 'searching', 'failed']).optional(),
+    cellularMode: z.enum(['active', 'searching', 'failed']).optional(),
+    batteryLevel: z.number().optional().describe('Battery level (0-100)'),
+    batteryState: z.enum(['charging', 'charged', 'discharging']).optional(),
+  }),
+  handler: async ({ udid, ...overrides }) => {
+    return simCtl.statusBar(udid, overrides);
+  },
+});
+
+registerTool({
+  name: 'sim_status_bar_clear',
+  description: 'Clear status bar overrides',
+  inputSchema: z.object({
+    udid: z.string().describe('Simulator UDID'),
+  }),
+  handler: async ({ udid }) => {
+    return simCtl.clearStatusBar(udid);
+  },
+});
+
+// ============================================================================
+// URL & Notifications
+// ============================================================================
+
+registerTool({
+  name: 'sim_open_url',
+  description: 'Open a URL on a simulator',
+  inputSchema: z.object({
+    udid: z.string().describe('Simulator UDID'),
+    url: z.string().describe('URL to open'),
+  }),
+  handler: async ({ udid, url }) => {
+    return simCtl.openURL(udid, url);
+  },
+});
+
+registerTool({
+  name: 'sim_push_notification',
+  description: 'Send a simulated push notification',
+  inputSchema: z.object({
+    udid: z.string().describe('Simulator UDID'),
+    bundleId: z.string().describe('App bundle identifier'),
+    payload: z.record(z.any()).describe('Push notification payload'),
+  }),
+  handler: async ({ udid, bundleId, payload }) => {
+    return simCtl.push(udid, bundleId, payload);
+  },
+});
+
+// ============================================================================
+// Privacy
+// ============================================================================
+
+registerTool({
+  name: 'sim_grant_privacy',
+  description: 'Grant privacy permission to an app',
+  inputSchema: z.object({
+    udid: z.string().describe('Simulator UDID'),
+    bundleId: z.string().describe('App bundle identifier'),
+    service: z.string().describe('Service name (e.g., camera, microphone, photos)'),
+  }),
+  handler: async ({ udid, bundleId, service }) => {
+    return simCtl.grantPrivacy(udid, bundleId, service);
+  },
+});
+
+registerTool({
+  name: 'sim_revoke_privacy',
+  description: 'Revoke privacy permission from an app',
+  inputSchema: z.object({
+    udid: z.string().describe('Simulator UDID'),
+    bundleId: z.string().describe('App bundle identifier'),
+    service: z.string().describe('Service name'),
+  }),
+  handler: async ({ udid, bundleId, service }) => {
+    return simCtl.revokePrivacy(udid, bundleId, service);
+  },
+});
+
+// ============================================================================
+// Keychain
+// ============================================================================
+
+registerTool({
+  name: 'sim_keychain_add',
+  description: 'Add item to simulator keychain',
+  inputSchema: z.object({
+    udid: z.string().describe('Simulator UDID'),
+    service: z.string().describe('Service name'),
+    account: z.string().describe('Account name'),
+    password: z.string().describe('Password'),
+  }),
+  handler: async ({ udid, service, account, password }) => {
+    return simCtl.keychainAdd(udid, service, account, password);
+  },
+});
+
+registerTool({
+  name: 'sim_keychain_reset',
+  description: 'Reset simulator keychain',
+  inputSchema: z.object({
+    udid: z.string().describe('Simulator UDID'),
+  }),
+  handler: async ({ udid }) => {
+    return simCtl.keychainReset(udid);
+  },
+});
+
+// ============================================================================
+// Environment & Diagnostics
+// ============================================================================
+
+registerTool({
+  name: 'sim_getenv',
+  description: 'Get environment variable from simulator',
+  inputSchema: z.object({
+    udid: z.string().describe('Simulator UDID'),
+    variable: z.string().optional().describe('Variable name (omit for all)'),
+  }),
+  handler: async ({ udid, variable }) => {
+    return simCtl.getenv(udid, variable);
+  },
+});
+
+registerTool({
+  name: 'sim_diagnose',
+  description: 'Collect simulator diagnostics',
+  inputSchema: z.object({
+    outputPath: z.string().optional().describe('Output path'),
+  }),
+  handler: async ({ outputPath }) => {
+    return simCtl.diagnose(outputPath);
+  },
+});
+
+// ============================================================================
+// Media & iCloud
+// ============================================================================
+
+registerTool({
+  name: 'sim_add_media',
+  description: 'Add media (photos/videos) to simulator',
+  inputSchema: z.object({
+    udid: z.string().describe('Simulator UDID'),
+    mediaPaths: z.union([z.string(), z.array(z.string())]).describe('Path(s) to media files'),
+  }),
+  handler: async ({ udid, mediaPaths }) => {
+    return simCtl.addMedia(udid, mediaPaths);
+  },
+});
+
+registerTool({
+  name: 'sim_icloud_sync',
+  description: 'Trigger iCloud sync on simulator',
+  inputSchema: z.object({
+    udid: z.string().describe('Simulator UDID'),
+  }),
+  handler: async ({ udid }) => {
+    return simCtl.icloudSync(udid);
+  },
+});
+
+// ============================================================================
+// Pasteboard
+// ============================================================================
+
+registerTool({
+  name: 'sim_pbpaste',
+  description: 'Get pasteboard contents from simulator',
+  inputSchema: z.object({
+    udid: z.string().describe('Simulator UDID'),
+  }),
+  handler: async ({ udid }) => {
+    return simCtl.pbpaste(udid);
+  },
+});
+
+// ============================================================================
+// UI
+// ============================================================================
+
+registerTool({
+  name: 'sim_set_appearance',
+  description: 'Set simulator appearance (light/dark mode)',
+  inputSchema: z.object({
+    udid: z.string().describe('Simulator UDID'),
+    appearance: z.enum(['light', 'dark']),
+  }),
+  handler: async ({ udid, appearance }) => {
+    return simCtl.setUI(udid, { appearance });
+  },
+});
+
+// ============================================================================
+// Runtime
+// ============================================================================
+
+registerTool({
+  name: 'sim_upgrade',
+  description: 'Upgrade simulator to a new runtime',
+  inputSchema: z.object({
+    udid: z.string().describe('Simulator UDID'),
+    runtimeId: z.string().describe('Target runtime ID'),
+  }),
+  handler: async ({ udid, runtimeId }) => {
+    return simCtl.upgrade(udid, runtimeId);
+  },
+});

package/tsconfig.json

@@ -0,0 +1,20 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "lib": ["ES2022"],
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "resolveJsonModule": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}