@ebowwa/mcp-ios-devices 1.0.7 → 1.1.2

package/dist/index.d.ts

@@ -22,6 +22,6 @@ import './tools/simulator.js';
 import './tools/backup.js';
 import './tools/location.js';
 import './tools/screenshot.js';
-import './tools/diagnostics.js';
 import './tools/profile.js';
+import './tools/build.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -29,8 +29,8 @@ import './tools/simulator.js';
 import './tools/backup.js';
 import './tools/location.js';
 import './tools/screenshot.js';
-import './tools/diagnostics.js';
 import './tools/profile.js';
+import './tools/build.js';
 // Create MCP server
 const server = new Server({
     name: '@ebowwa/mcp-ios-devices',

package/dist/tools/build.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=build.d.ts.map

package/dist/tools/build.js

@@ -0,0 +1,281 @@
+/**
+ * Build, Test & Debug Tools
+ * Xcode build, test, debug, and performance profiling operations
+ */
+import { z } from 'zod';
+import { registerTool } from '../registry.js';
+import { xcodeTools } from '@ebowwa/ios-devices';
+// ============================================================================
+// Build Tools
+// ============================================================================
+registerTool({
+    name: 'ios_build_app',
+    description: `Build an iOS app using xcodebuild.
+
+Supports building for device or simulator. Returns build status, warnings, errors, and app path.
+
+Examples:
+- Build for simulator: { scheme: "MyApp", destination: "platform=iOS Simulator,name=iPhone 15" }
+- Build for device: { scheme: "MyApp", destination: "platform=iOS,name=Starlink" }
+- Build with workspace: { workspace: "MyApp.xcworkspace", scheme: "MyApp" }`,
+    inputSchema: z.object({
+        project: z.string().optional().describe('Path to .xcodeproj file'),
+        workspace: z.string().optional().describe('Path to .xcworkspace file'),
+        scheme: z.string().describe('Build scheme name'),
+        configuration: z.enum(['Debug', 'Release']).optional().default('Debug'),
+        destination: z.string().optional().describe('Build destination (e.g., "platform=iOS,name=Starlink")'),
+        sdk: z.string().optional().describe('SDK to use (e.g., "iphoneos", "iphonesimulator")'),
+        derivedDataPath: z.string().optional().describe('Path for derived data'),
+        codeSignIdentity: z.string().optional().describe('Code signing identity'),
+        provisioningProfile: z.string().optional().describe('Provisioning profile UUID'),
+        extraArgs: z.array(z.string()).optional().describe('Additional xcodebuild arguments'),
+    }),
+    handler: async (options) => {
+        return xcodeTools.buildApp(options);
+    },
+});
+registerTool({
+    name: 'ios_archive_app',
+    description: `Archive an iOS app for distribution.
+
+Creates an .xcarchive that can be exported to IPA.
+
+Examples:
+- Archive for release: { scheme: "MyApp", archivePath: "/tmp/MyApp.xcarchive", configuration: "Release" }`,
+    inputSchema: z.object({
+        project: z.string().optional().describe('Path to .xcodeproj file'),
+        workspace: z.string().optional().describe('Path to .xcworkspace file'),
+        scheme: z.string().describe('Build scheme name'),
+        configuration: z.enum(['Debug', 'Release']).optional().default('Release'),
+        archivePath: z.string().describe('Path for the .xcarchive'),
+        destination: z.string().optional().describe('Build destination'),
+    }),
+    handler: async (options) => {
+        return xcodeTools.archiveApp(options);
+    },
+});
+registerTool({
+    name: 'ios_export_ipa',
+    description: `Export IPA from archive for distribution.
+
+Requires an export options plist for code signing configuration.
+
+Examples:
+- Export for App Store: { archivePath: "/tmp/MyApp.xcarchive", exportPath: "/tmp/export", exportOptionsPlist: "/tmp/ExportOptions.plist" }`,
+    inputSchema: z.object({
+        archivePath: z.string().describe('Path to .xcarchive'),
+        exportPath: z.string().describe('Directory for exported IPA'),
+        exportOptionsPlist: z.string().describe('Path to ExportOptions.plist'),
+    }),
+    handler: async (options) => {
+        return xcodeTools.exportIPA(options);
+    },
+});
+// ============================================================================
+// Test Tools
+// ============================================================================
+registerTool({
+    name: 'ios_run_tests',
+    description: `Run unit/UI tests using xcodebuild test.
+
+Returns test results with pass/fail counts and individual test outcomes.
+
+Examples:
+- Run all tests: { scheme: "MyAppTests", destination: "platform=iOS Simulator,name=iPhone 15" }
+- Run specific test: { scheme: "MyAppTests", onlyTesting: ["MyAppTests/MyTestClass/testMethod"] }
+- Run test plan: { scheme: "MyApp", testPlan: "AllTests" }`,
+    inputSchema: z.object({
+        project: z.string().optional().describe('Path to .xcodeproj file'),
+        workspace: z.string().optional().describe('Path to .xcworkspace file'),
+        scheme: z.string().describe('Test scheme name'),
+        configuration: z.enum(['Debug', 'Release']).optional().default('Debug'),
+        destination: z.string().optional().describe('Test destination (device or simulator)'),
+        testPlan: z.string().optional().describe('Test plan name'),
+        onlyTesting: z.array(z.string()).optional().describe('Specific tests to run (e.g., ["TestClass/testMethod"])'),
+        skipTesting: z.array(z.string()).optional().describe('Tests to skip'),
+        parallelTesting: z.boolean().optional().default(false).describe('Enable parallel testing'),
+        retryCount: z.number().optional().describe('Number of times to retry failed tests'),
+    }),
+    handler: async (options) => {
+        return xcodeTools.runTests(options);
+    },
+});
+// ============================================================================
+// Debug Tools
+// ============================================================================
+registerTool({
+    name: 'ios_debug_app',
+    description: `Start debugging an app on device using lldb.
+
+Launches the app and attaches the debugger. Use for debugging crashes, breakpoints, etc.
+
+Examples:
+- Debug app: { deviceId: "00008030-00146...", bundleId: "com.myapp.ios" }
+- Wait for debugger: { deviceId: "...", bundleId: "com.myapp.ios", waitForDebugger: true }
+- With environment: { deviceId: "...", bundleId: "com.myapp.ios", environment: { "DEBUG": "1" } }`,
+    inputSchema: z.object({
+        deviceId: z.string().describe('Device UDID'),
+        bundleId: z.string().describe('App bundle identifier'),
+        waitForDebugger: z.boolean().optional().default(false).describe('Wait for debugger to attach before launching'),
+        environment: z.record(z.string()).optional().describe('Environment variables to set'),
+        arguments: z.array(z.string()).optional().describe('Command line arguments'),
+    }),
+    handler: async (options) => {
+        return xcodeTools.startDebugServer(options);
+    },
+});
+registerTool({
+    name: 'ios_attach_debugger',
+    description: `Attach debugger to a running process.
+
+Attaches lldb to an already running app for debugging.
+
+Examples:
+- Attach by bundle ID: { deviceId: "...", bundleId: "com.myapp.ios" }
+- Attach by PID: { deviceId: "...", bundleId: "com.myapp.ios", pid: 12345 }`,
+    inputSchema: z.object({
+        deviceId: z.string().describe('Device UDID'),
+        bundleId: z.string().describe('App bundle identifier'),
+        pid: z.number().optional().describe('Process ID (optional, uses bundle ID if omitted)'),
+    }),
+    handler: async (options) => {
+        return xcodeTools.attachToProcess(options);
+    },
+});
+// ============================================================================
+// App Console (Filtered Logs)
+// ============================================================================
+registerTool({
+    name: 'ios_app_console',
+    description: `Stream console logs for a specific app.
+
+Filters device logs to show only messages from the specified app. Useful for debugging app behavior.
+
+Examples:
+- Stream app logs for 30s: { deviceId: "...", bundleId: "com.myapp.ios" }
+- Extended logging: { deviceId: "...", bundleId: "com.myapp.ios", timeoutSeconds: 60, maxLines: 2000 }`,
+    inputSchema: z.object({
+        deviceId: z.string().describe('Device UDID'),
+        bundleId: z.string().describe('App bundle identifier to filter logs'),
+        timeoutSeconds: z.number().min(5).max(300).default(30).describe('How long to collect logs'),
+        maxLines: z.number().min(10).max(5000).default(500).optional().describe('Maximum log lines'),
+        includeSystem: z.boolean().optional().default(false).describe('Include system logs (not just app)'),
+    }),
+    handler: async ({ deviceId, bundleId, timeoutSeconds, maxLines, includeSystem }) => {
+        const result = await xcodeTools.streamAppConsole({
+            deviceId,
+            bundleId,
+            timeoutMs: timeoutSeconds * 1000,
+            maxLines,
+            includeSystem,
+        });
+        return {
+            logCount: result.logs.length,
+            truncated: result.truncated,
+            logs: result.logs,
+            bundleId,
+        };
+    },
+});
+// ============================================================================
+// Performance Profiling (Instruments)
+// ============================================================================
+registerTool({
+    name: 'ios_list_instruments_templates',
+    description: `List available Instruments templates for profiling.
+
+Returns all available profiling templates like Time Profiler, Allocations, Leaks, etc.
+
+Example:
+- List templates: {}`,
+    inputSchema: z.object({}),
+    handler: async () => {
+        return xcodeTools.listInstrumentsTemplates();
+    },
+});
+registerTool({
+    name: 'ios_run_instruments',
+    description: `Run Instruments profiling on device.
+
+Profiles app performance using the specified template. Results saved to trace file.
+
+Examples:
+- Time profile: { deviceId: "...", bundleId: "com.myapp.ios", template: "Time Profiler", outputPath: "/tmp/trace.trace" }
+- Memory profile: { deviceId: "...", bundleId: "com.myapp.ios", template: "Allocations", outputPath: "/tmp/alloc.trace" }
+- Leaks check: { deviceId: "...", bundleId: "com.myapp.ios", template: "Leaks", outputPath: "/tmp/leaks.trace" }`,
+    inputSchema: z.object({
+        deviceId: z.string().describe('Device UDID'),
+        template: z.string().describe('Instruments template name (e.g., "Time Profiler", "Allocations", "Leaks")'),
+        bundleId: z.string().optional().describe('App bundle identifier'),
+        appPath: z.string().optional().describe('Path to .app bundle'),
+        outputPath: z.string().describe('Path for output .trace file'),
+        duration: z.number().optional().default(60).describe('Profiling duration in seconds'),
+        extraArgs: z.array(z.string()).optional().describe('Additional instruments arguments'),
+    }),
+    handler: async (options) => {
+        return xcodeTools.runInstruments({
+            deviceId: options.deviceId,
+            template: options.template,
+            bundleId: options.bundleId,
+            appPath: options.appPath,
+            outputPath: options.outputPath,
+            duration: options.duration,
+            extraArgs: options.extraArgs,
+        });
+    },
+});
+registerTool({
+    name: 'ios_profile_time',
+    description: `Run Time Profiler on app.
+
+Profiles CPU usage to identify performance bottlenecks.
+
+Examples:
+- Profile for 60s: { deviceId: "...", bundleId: "com.myapp.ios", outputPath: "/tmp/time-profile.trace" }`,
+    inputSchema: z.object({
+        deviceId: z.string().describe('Device UDID'),
+        bundleId: z.string().describe('App bundle identifier'),
+        outputPath: z.string().describe('Path for output .trace file'),
+        duration: z.number().optional().default(60).describe('Profiling duration in seconds'),
+    }),
+    handler: async (options) => {
+        return xcodeTools.runTimeProfiler(options);
+    },
+});
+registerTool({
+    name: 'ios_profile_memory',
+    description: `Run Allocations profiler on app.
+
+Tracks memory allocations to identify memory usage patterns.
+
+Examples:
+- Profile memory: { deviceId: "...", bundleId: "com.myapp.ios", outputPath: "/tmp/allocations.trace" }`,
+    inputSchema: z.object({
+        deviceId: z.string().describe('Device UDID'),
+        bundleId: z.string().describe('App bundle identifier'),
+        outputPath: z.string().describe('Path for output .trace file'),
+        duration: z.number().optional().default(60).describe('Profiling duration in seconds'),
+    }),
+    handler: async (options) => {
+        return xcodeTools.runAllocationsProfiler(options);
+    },
+});
+registerTool({
+    name: 'ios_profile_leaks',
+    description: `Run Leaks profiler on app.
+
+Detects memory leaks in the application.
+
+Examples:
+- Check for leaks: { deviceId: "...", bundleId: "com.myapp.ios", outputPath: "/tmp/leaks.trace" }`,
+    inputSchema: z.object({
+        deviceId: z.string().describe('Device UDID'),
+        bundleId: z.string().describe('App bundle identifier'),
+        outputPath: z.string().describe('Path for output .trace file'),
+        duration: z.number().optional().default(60).describe('Profiling duration in seconds'),
+    }),
+    handler: async (options) => {
+        return xcodeTools.runLeaksProfiler(options);
+    },
+});
+//# sourceMappingURL=build.js.map

package/dist/tools/diagnostics.js

@@ -2,80 +2,7 @@
  * Diagnostics Tools
  * Device diagnostics and information
  */
-import { z } from 'zod';
-import { registerTool } from '../registry.js';
-import { LibIMobileDevice } from '@ebowwa/ios-devices';
-registerTool({
-    name: 'ios_get_diagnostics',
-    description: 'Get device diagnostics (WiFi, Battery, NAND, etc.)',
-    inputSchema: z.object({
-        deviceId: z.string().describe('Device UDID'),
-        type: z.enum(['All', 'WiFi', 'GasGauge', 'NAND', 'Battery', 'HDMI']).default('All'),
-    }),
-    handler: async ({ deviceId, type }) => {
-        const lib = new LibIMobileDevice({ udid: deviceId });
-        return lib.getDiagnostics(type);
-    },
-});
-registerTool({
-    name: 'ios_get_ioreg',
-    description: 'Get IO Registry information',
-    inputSchema: z.object({
-        deviceId: z.string().describe('Device UDID'),
-        plane: z.enum(['IODeviceTree', 'IOPower', 'IOService']).optional(),
-    }),
-    handler: async ({ deviceId, plane }) => {
-        const lib = new LibIMobileDevice({ udid: deviceId });
-        return lib.getIORegistry(plane);
-    },
-});
-registerTool({
-    name: 'ios_get_mobilegestalt',
-    description: 'Get MobileGestalt values from device',
-    inputSchema: z.object({
-        deviceId: z.string().describe('Device UDID'),
-        keys: z.array(z.string()).describe('Keys to query'),
-    }),
-    handler: async ({ deviceId, keys }) => {
-        const lib = new LibIMobileDevice({ udid: deviceId });
-        return lib.getMobileGestalt(...keys);
-    },
-});
-registerTool({
-    name: 'ios_mount_image',
-    description: 'Mount developer disk image on device',
-    inputSchema: z.object({
-        deviceId: z.string().describe('Device UDID'),
-        imagePath: z.string().describe('Path to developer disk image'),
-        signaturePath: z.string().optional().describe('Path to signature file'),
-    }),
-    handler: async ({ deviceId, imagePath, signaturePath }) => {
-        const lib = new LibIMobileDevice({ udid: deviceId });
-        return lib.mountImage(imagePath, signaturePath);
-    },
-});
-registerTool({
-    name: 'ios_start_debug_server',
-    description: 'Start debug server proxy for remote debugging',
-    inputSchema: z.object({
-        deviceId: z.string().describe('Device UDID'),
-        port: z.number().default(6666).describe('Port for debug server'),
-    }),
-    handler: async ({ deviceId, port }) => {
-        const lib = new LibIMobileDevice({ udid: deviceId });
-        return lib.startDebugServerProxy(port);
-    },
-});
-registerTool({
-    name: 'ios_start_bluetooth_logger',
-    description: 'Start Bluetooth packet logging',
-    inputSchema: z.object({
-        deviceId: z.string().describe('Device UDID'),
-        outputPath: z.string().optional().describe('Output file path'),
-    }),
-    handler: async ({ deviceId, outputPath }) => {
-        const lib = new LibIMobileDevice({ udid: deviceId });
-        return lib.startBluetoothLogging(outputPath);
-    },
-});
+from;
+'@ebowwa/ios-devices';
+export {};
 //# sourceMappingURL=diagnostics.js.map

package/dist/tools/log.d.ts

@@ -1,6 +1,6 @@
 /**
  * Logging & Diagnostics Tools
- * Collect logs and diagnostic information from iOS devices
+ * Collect logs and diagnostic information from iOS device
  */
 export {};
 //# sourceMappingURL=log.d.ts.map

package/dist/tools/log.js

@@ -1,10 +1,36 @@
 /**
  * Logging & Diagnostics Tools
- * Collect logs and diagnostic information from iOS devices
+ * Collect logs and diagnostic information from iOS device
  */
 import { z } from 'zod';
 import { registerTool } from '../registry.js';
 import { LibIMobileDevice, DeviceCtl } from '@ebowwa/ios-devices';
+registerTool({
+    name: 'ios_get_device_logs',
+    description: `Get device logs via xcrun devicectl (iOS 17+).
+
+Retrieves log information and entries from the device using devicectl.
+Works with modern devices that support devicectl.
+
+Examples:
+- Get logs from device: { deviceId: "00008030-00146..." }
+- With custom timeout: { deviceId: "...", timeout: 60 }`,
+    inputSchema: z.object({
+        deviceId: z.string().describe('Device UDID'),
+        timeout: z.number().min(10).max(300).default(60).optional().describe('Timeout in seconds (default 120)'),
+    }),
+    handler: async ({ deviceId, timeout }) => {
+        const deviceCtl = new DeviceCtl();
+        const result = await deviceCtl.getDeviceLogs(deviceId, {
+            timeout: (timeout ?? 120) * 1000,
+        });
+        return {
+            success: result.success,
+            logs: result.stdout,
+            error: result.stderr || undefined,
+        };
+    },
+});
 registerTool({
     name: 'ios_stream_syslog',
     description: `Stream syslog from device with timeout control.
@@ -35,7 +61,7 @@ Examples:
             logCount: result.logs.length,
             truncated: result.truncated,
             logs: result.logs,
-            rawOutput: result.rawOutput.slice(0, 5000), // Include first 5000 chars of raw output
+            rawOutput: result.rawOutput.slice(0, 5000),
         };
     },
 });
@@ -51,6 +77,20 @@ registerTool({
         return lib.getSyslogArchive(outputPath);
     },
 });
+registerTool({
+    name: 'ios_download_crash_reports',
+    description: 'Download crash reports from device',
+    inputSchema: z.object({
+        deviceId: z.string().describe('Device UDID'),
+        outputDirectory: z.string().describe('Directory to save crash reports'),
+        extract: z.boolean().optional().describe('Extract crash reports'),
+        keep: z.boolean().optional().describe('Keep reports on device'),
+    }),
+    handler: async ({ deviceId, outputDirectory, extract, keep }) => {
+        const lib = new LibIMobileDevice({ udid: deviceId });
+        return lib.downloadCrashReports(outputDirectory, { extract, keep });
+    },
+});
 registerTool({
     name: 'ios_collect_diagnostics',
     description: `Collect diagnostic information from device(s).
@@ -69,30 +109,34 @@ Examples:
         const deviceCtl = new DeviceCtl();
         const result = await deviceCtl.collectDiagnostics({
             devices: deviceId,
-            archiveDestination
+            archiveDestination,
         });
+        if (!result.success) {
+            return {
+                success: false,
+                stdout: '',
+                stderr: result.stderr,
+                exitCode: result.exitCode,
+            };
+        }
+        try {
+            const parsed = JSON.parse(result.stdout);
+            if (parsed?.diagnosticEntries) {
+                return parsed.diagnosticEntries;
+            }
+        }
+        catch {
+            // Not valid JSON, return raw output
+        }
         return {
             success: result.success,
-            archivePath: archiveDestination || '/tmp/devicectl_diagnose_<timestamp>.zip',
+            archivePath: archiveDestination || `/tmp/devicectl_diagnose_${new Date().toISOString()}.zip`,
             stdout: result.stdout,
             stderr: result.stderr,
+            exitCode: result.exitCode,
         };
     },
 });
-registerTool({
-    name: 'ios_download_crash_reports',
-    description: 'Download crash reports from device',
-    inputSchema: z.object({
-        deviceId: z.string().describe('Device UDID'),
-        outputDirectory: z.string().describe('Directory to save crash reports'),
-        extract: z.boolean().optional().describe('Extract crash reports'),
-        keep: z.boolean().optional().describe('Keep reports on device'),
-    }),
-    handler: async ({ deviceId, outputDirectory, extract, keep }) => {
-        const lib = new LibIMobileDevice({ udid: deviceId });
-        return lib.downloadCrashReports(outputDirectory, { extract, keep });
-    },
-});
 registerTool({
     name: 'ios_get_diagnostics',
     description: 'Get diagnostics information (WiFi, Battery, NAND, etc.)',

package/head

@@ -0,0 +1,50 @@
+error: unknown switch `5'
+error: unknown switch `5'
+usage: git status [<options>] [--] [<pathspec>...]
+
+    -v, --[no-]verbose    be verbose
+    -s, --[no-]short      show status concisely
+    -b, --[no-]branch     show branch information
+    --[no-]show-stash     show stash information
+    --[no-]ahead-behind   compute full ahead/behind values
+    --[no-]porcelainusage: git status [<options>] [--] [<pathspec>...]
+
+    -v, --[no-]verbose    be verbose
+    -s, --[no-]short      show status concisely
+    -b, --[no-]branch     show branch information
+    --[no-]show-stash     show stash information
+    --[no-]ahead-behind   compute full ahead/behind values
+    --[no-]porcelain[=<version>][=<version>]
+                          machine-readable output
+    --[no-]long           show status in long format (default)
+    -z, --[no-]null
+                          machine-readable output
+    --[no-]long           show status in long format (default)
+    -z, --[no-]null       terminate entries with NUL
+    -u, --[no-]untracked-files[=<mode>]       terminate entries with NUL
+    -u, --[no-]untracked-files[=<mode>]
+                          show untracked files, optional modes: all, normal, no. (Default: all)
+    --[no-]ignored[=<mode>]
+                          show untracked files, optional modes: all, normal, no. (Default: all)
+    --[no-]ignored[=<mode>]
+                          show ignored files, optional modes: traditional, matching, no. (Default: traditional)
+    --[no-]ignore-submodules[=<when>]
+                          show ignored files, optional modes: traditional, matching, no. (Default: traditional)
+    --[no-]ignore-submodules[=<when>]
+                          ignore changes to submodules, optional when: all, dirty, untracked. (Default: all)
+    --[no-]column[=<style>]
+                          ignore changes to submodules, optional when: all, dirty, untracked. (Default: all)
+    --[no-]column[=<style>]
+                          list untracked files in columns
+    --no-renames          do not detect renames
+
+                          list untracked files in columns
+    --no-renames          do not detect renames
+    --renames             opposite of --no-renames    --renames             opposite of --no-renames
+    -M, --find-renames
+    -M, --find-renames[=<n>]
+                          detect renames, optionally set similarity index
+
+[=<n>]
+                          detect renames, optionally set similarity index
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ebowwa/mcp-ios-devices",
-  "version": "1.0.7",
+  "version": "1.1.2",
   "description": "MCP server for iOS device control - devicectl, libimobiledevice, simctl",
   "type": "module",
   "main": "dist/index.js",
@@ -31,7 +31,7 @@
   "license": "MIT",
   "dependencies": {
     "@anthropic-ai/sdk": "^0.39.0",
-    "@ebowwa/ios-devices": "^1.0.5",
+    "@ebowwa/ios-devices": "^1.1.0",
     "@modelcontextprotocol/sdk": "^1.0.0",
     "zod": "^3.22.0"
   },

package/src/index.ts

@@ -38,8 +38,8 @@ import './tools/simulator.js';
 import './tools/backup.js';
 import './tools/location.js';
 import './tools/screenshot.js';
-import './tools/diagnostics.js';
 import './tools/profile.js';
+import './tools/build.js';
 
 // Create MCP server
 const server = new Server(