Adding Unit Testing Tool for iOS

src/index.ts

@@ -25,6 +25,9 @@ import {
   registerIOSSimulatorBuildAndRunTools,
 } from './tools/build_ios_simulator.js';
 
+// Import iOS simulator test tools
+import { registerIOSSimulatorTestTools } from './tools/test_ios_simulator.js';
+
 // Import iOS device build tools
 import { registerIOSDeviceBuildTools } from './tools/build_ios_device.js';
 
@@ -142,6 +145,9 @@ async function main(): Promise<void> {
     // Register log capture tools
     registerStartSimulatorLogCaptureTool(server);
     registerStopAndGetSimulatorLogTool(server);
+
+    // Register test tools
+    registerIOSSimulatorTestTools(server);
 
     // Start the server
     await startServer(server);

src/tools/test_ios_simulator.ts

@@ -0,0 +1,186 @@
+/**
+ * iOS Simulator Test Tools - Tools for running tests on iOS applications in simulators
+ * 
+ * This module provides specialized tools for running tests on iOS applications in simulators
+ * using xcodebuild test. It supports both workspace and project-based testing with simulator targeting
+ * by name or UUID, and includes test failure parsing.
+ * 
+ * Responsibilities:
+ * - Running tests on iOS applications in simulators from project files and workspaces
+ * - Supporting simulator targeting by name or UUID
+ * - Parsing and summarizing test failure results
+ * - Handling test configuration and derived data paths
+ */
+
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { XcodePlatform, executeXcodeCommand } from '../utils/xcode.js';
+import { executeXcodeBuild } from '../utils/build-utils.js';
+import { log } from '../utils/logger.js';
+import { createTextResponse } from '../utils/validation.js';
+import { ToolResponse, ToolResponseContent } from '../types/common.js';
+import { 
+  registerTool,
+  workspacePathSchema,
+  projectPathSchema,
+  schemeSchema,
+  configurationSchema, 
+  derivedDataPathSchema,
+  extraArgsSchema,
+  simulatorNameSchema,
+  simulatorIdSchema,
+  useLatestOSSchema
+} from './common.js';
+
+// --- internal logic ---
+async function _handleIOSSimulatorTestLogic(params: {
+  workspacePath?: string;
+  projectPath?: string;
+  scheme: string;
+  configuration: string;
+  simulatorName?: string;
+  simulatorId?: string;
+  useLatestOS: boolean;
+  derivedDataPath?: string;
+  extraArgs?: string[];
+}): Promise<ToolResponse> {
+  log('info', `Starting iOS Simulator tests for scheme ${params.scheme} (internal)`);
+
+  const buildResult = await executeXcodeBuild(
+    {
+      ...params,
+    },
+    {
+      platform: XcodePlatform.iOSSimulator,
+      simulatorName: params.simulatorName,
+      simulatorId: params.simulatorId,
+      useLatestOS: params.useLatestOS,
+      logPrefix: 'iOS Simulator Test',
+    },
+    'test',
+  );
+
+  if (buildResult.isError) return buildResult;
+
+  // --- Parse failures ---
+  const raw = buildResult.rawOutput ?? '';
+  const failures = raw
+    .split('\n')
+    .filter(l => /Test Case .* failed/.test(l))
+    .map(l => {
+      const m = l.match(/Test Case '(.*)' failed \((.*)\)/)!;
+      return { testCase: m[1], reason: m[2] };
+    });
+
+  const summary = failures.length
+    ? `❌ ${failures.length} test(s) failed`
+    : '✅ All tests passed';
+
+  const content: ToolResponseContent[] = [
+    { type: 'text', text: summary }
+  ];
+
+  // Add failures as formatted text if any exist
+  if (failures.length > 0) {
+    content.push({ 
+      type: 'text', 
+      text: `Test failures:\n${failures.map(f => `- ${f.testCase}: ${f.reason}`).join('\n')}`
+    });
+  }
+
+  return { content };
+}
+
+/**
+ * Register all iOS Simulator test tools with the MCP server
+ */
+export function registerIOSSimulatorTestTools(server: McpServer): void {
+  // Common default values
+  const defaults = {
+    configuration: 'Debug',
+    useLatestOS: true,
+  };
+
+  // 1) workspace + name
+  registerTool(
+    server,
+    'ios_simulator_test_by_name_workspace',
+    'Run tests for an iOS app on a simulator specified by name using a workspace',
+    {
+      workspacePath: workspacePathSchema,
+      scheme: schemeSchema,
+      simulatorName: simulatorNameSchema,
+      configuration: configurationSchema,
+      derivedDataPath: derivedDataPathSchema,
+      extraArgs: extraArgsSchema,
+      useLatestOS: useLatestOSSchema,
+    },
+    (params: any) => _handleIOSSimulatorTestLogic({ 
+      ...params, 
+      configuration: params.configuration || defaults.configuration,
+      useLatestOS: params.useLatestOS ?? defaults.useLatestOS
+    })
+  );
+
+  // 2) project + name
+  registerTool(
+    server,
+    'ios_simulator_test_by_name_project',
+    'Run tests for an iOS app on a simulator specified by name using a project file',
+    {
+      projectPath: projectPathSchema,
+      scheme: schemeSchema,
+      simulatorName: simulatorNameSchema,
+      configuration: configurationSchema,
+      derivedDataPath: derivedDataPathSchema,
+      extraArgs: extraArgsSchema,
+      useLatestOS: useLatestOSSchema,
+    },
+    (params: any) => _handleIOSSimulatorTestLogic({ 
+      ...params, 
+      configuration: params.configuration || defaults.configuration,
+      useLatestOS: params.useLatestOS ?? defaults.useLatestOS
+    })
+  );
+
+  // 3) workspace + id
+  registerTool(
+    server,
+    'ios_simulator_test_by_id_workspace',
+    'Run tests for an iOS app on a simulator specified by ID using a workspace',
+    {
+      workspacePath: workspacePathSchema,
+      scheme: schemeSchema,
+      simulatorId: simulatorIdSchema,
+      configuration: configurationSchema,
+      derivedDataPath: derivedDataPathSchema,
+      extraArgs: extraArgsSchema,
+      useLatestOS: useLatestOSSchema,
+    },
+    (params: any) => _handleIOSSimulatorTestLogic({ 
+      ...params, 
+      configuration: params.configuration || defaults.configuration,
+      useLatestOS: params.useLatestOS ?? defaults.useLatestOS
+    })
+  );
+
+  // 4) project + id
+  registerTool(
+    server,
+    'ios_simulator_test_by_id_project',
+    'Run tests for an iOS app on a simulator specified by ID using a project file',
+    {
+      projectPath: projectPathSchema,
+      scheme: schemeSchema,
+      simulatorId: simulatorIdSchema,
+      configuration: configurationSchema,
+      derivedDataPath: derivedDataPathSchema,
+      extraArgs: extraArgsSchema,
+      useLatestOS: useLatestOSSchema,
+    },
+    (params: any) => _handleIOSSimulatorTestLogic({ 
+      ...params, 
+      configuration: params.configuration || defaults.configuration,
+      useLatestOS: params.useLatestOS ?? defaults.useLatestOS
+    })
+  );
+}

src/types/common.ts

@@ -35,6 +35,7 @@ export interface ToolResponse {
   content: ToolResponseContent[];
   isError?: boolean;
   _meta?: Record<string, unknown>;
+  rawOutput?: string; // Raw output from command execution
   [key: string]: unknown; // Index signature to match CallToolResult
 }
 

src/utils/build-utils.ts

@@ -206,6 +206,7 @@ When done capturing logs, use: stop_and_get_simulator_log({ logSessionId: 'SESSI
           text: `✅ ${platformOptions.logPrefix} ${buildAction} succeeded for scheme ${params.scheme}.`,
         },
       ],
+      rawOutput: result.output + (result.error ? '\n' + result.error : ''),
     };
 
     // Only add additional info if we have any