get_app_bundle_id

Instructions

Implementation Reference

• src/mcp/tools/project-discovery/get_app_bundle_id.ts:46-124 (handler)

  The core handler function that implements the tool logic: validates app path, checks existence, extracts CFBundleIdentifier from Info or Info.plist using defaults read or PlistBuddy, returns success/error response with next steps.

  export async function get_app_bundle_idLogic(
    params: GetAppBundleIdParams,
    executor: CommandExecutor,
    fileSystemExecutor: FileSystemExecutor,
  ): Promise<ToolResponse> {
    // Zod validation is handled by createTypedTool, so params.appPath is guaranteed to be a string
    const appPath = params.appPath;
  
    if (!fileSystemExecutor.existsSync(appPath)) {
      return {
        content: [
          {
            type: 'text',
            text: `File not found: '${appPath}'. Please check the path and try again.`,
          },
        ],
        isError: true,
      };
    }
  
    log('info', `Starting bundle ID extraction for app: ${appPath}`);
  
    try {
      let bundleId;
  
      try {
        bundleId = await executeSyncCommand(
          `defaults read "${appPath}/Info" CFBundleIdentifier`,
          executor,
        );
      } catch {
        try {
          bundleId = await executeSyncCommand(
            `/usr/libexec/PlistBuddy -c "Print :CFBundleIdentifier" "${appPath}/Info.plist"`,
            executor,
          );
        } catch (innerError) {
          throw new Error(
            `Could not extract bundle ID from Info.plist: ${innerError instanceof Error ? innerError.message : String(innerError)}`,
          );
        }
      }
  
      log('info', `Extracted app bundle ID: ${bundleId}`);
  
      return {
        content: [
          {
            type: 'text',
            text: `✅ Bundle ID: ${bundleId}`,
          },
          {
            type: 'text',
            text: `Next Steps:
  - Simulator: install_app_sim + launch_app_sim
  - Device: install_app_device + launch_app_device`,
          },
        ],
        isError: false,
      };
    } catch (error) {
      const errorMessage = error instanceof Error ? error.message : String(error);
      log('error', `Error extracting app bundle ID: ${errorMessage}`);
  
      return {
        content: [
          {
            type: 'text',
            text: `Error extracting app bundle ID: ${errorMessage}`,
          },
          {
            type: 'text',
            text: `Make sure the path points to a valid app bundle (.app directory).`,
          },
        ],
        isError: true,
      };
    }
  }

• src/mcp/tools/project-discovery/get_app_bundle_id.ts:20-29 (schema)

  Zod schema for input validation defining 'appPath' parameter and inferred TypeScript type.

  const getAppBundleIdSchema = z.object({
    appPath: z
      .string()
      .describe(
        'Path to the .app bundle to extract bundle ID from (full path to the .app directory)',
      ),
  });
  
  // Use z.infer for type safety
  type GetAppBundleIdParams = z.infer<typeof getAppBundleIdSchema>;

• src/mcp/tools/project-discovery/get_app_bundle_id.ts:126-137 (registration)

  Default export registering the tool with name, description, schema (MCP compatible), and typed handler wrapping the logic function.

  export default {
    name: 'get_app_bundle_id',
    description:
      "Extracts the bundle identifier from an app bundle (.app) for any Apple platform (iOS, iPadOS, watchOS, tvOS, visionOS). IMPORTANT: You MUST provide the appPath parameter. Example: get_app_bundle_id({ appPath: '/path/to/your/app.app' })",
    schema: getAppBundleIdSchema.shape, // MCP SDK compatibility
    handler: createTypedTool(
      getAppBundleIdSchema,
      (params: GetAppBundleIdParams) =>
        get_app_bundle_idLogic(params, getDefaultCommandExecutor(), getDefaultFileSystemExecutor()),
      getDefaultCommandExecutor,
    ),
  };

• src/mcp/tools/project-discovery/get_app_bundle_id.ts:34-40 (helper)

  Utility function to run shell commands synchronously via the CommandExecutor, throwing on failure.

  async function executeSyncCommand(command: string, executor: CommandExecutor): Promise<string> {
    const result = await executor(['/bin/sh', '-c', command], 'Bundle ID Extraction');
    if (!result.success) {
      throw new Error(result.error ?? 'Command failed');
    }
    return result.output || '';
  }

• src/mcp/tools/device/get_app_bundle_id.ts:1-3 (registration)

  Re-export of the main tool for device workflow context.

  // Re-export from project-discovery to complete workflow
  export { default } from '../project-discovery/get_app_bundle_id.ts';