xcode_get_run_destinations

Retrieve available run destinations for an Xcode project to configure build targets and deployment options.

Instructions

Get list of available run destinations for a specific project

Input Schema

TableJSON Schema

Name	Required	Description	Default
`xcodeproj`	Yes	Absolute path to the .xcodeproj file (or .xcworkspace if available) - e.g., /path/to/project.xcodeproj

Implementation Reference

src/tools/ProjectTools.ts:426-463 (handler)

Executes the core tool logic: validates project path, ensures project is open in Xcode, runs JXA script to fetch workspace.runDestinations(), formats as JSON with active status, handles empty results.

public static async getRunDestinations(projectPath: string, openProject: OpenProjectCallback): Promise<McpResult> {
  const validationError = PathValidator.validateProjectPath(projectPath);
  if (validationError) return validationError;

  await openProject(projectPath);

  const script = `
    (function() {
      ${getWorkspaceByPathScript(projectPath)}
      
      const destinations = workspace.runDestinations();
      const activeDestination = workspace.activeRunDestination();
      
      const destInfo = destinations.map(dest => ({
        name: dest.name(),
        platform: dest.platform(),
        architecture: dest.architecture(),
        isActive: activeDestination && dest.name() === activeDestination.name()
      }));
      
      return JSON.stringify(destInfo, null, 2);
    })()
  `;
  
  const result = await JXAExecutor.execute(script);
  
  // Parse the result to check if destinations array is empty
  try {
    const destInfo = JSON.parse(result);
    if (Array.isArray(destInfo) && destInfo.length === 0) {
      return { content: [{ type: 'text', text: 'No run destinations found for the project' }] };
    }
  } catch (error) {
    // If parsing fails, return the raw result
  }
  
  return { content: [{ type: 'text', text: result }] };
}

src/shared/toolDefinitions.ts:250-263 (schema)

Defines the tool name, description, and input schema requiring the xcodeproj path (absolute path to Xcode project/workspace).

name: 'xcode_get_run_destinations',
description: 'Get list of available run destinations for a specific project',
inputSchema: {
  type: 'object',
  properties: {
    xcodeproj: {
      type: 'string',
      description: preferredXcodeproj 
        ? `Absolute path to the .xcodeproj file (or .xcworkspace if available) - defaults to ${preferredXcodeproj}`
        : 'Absolute path to the .xcodeproj file (or .xcworkspace if available) - e.g., /path/to/project.xcodeproj',
    },
  },
  required: preferredXcodeproj ? [] : ['xcodeproj'],
},

src/XcodeServer.ts:494-498 (registration)

Registers the tool in the MCP server's CallToolRequest handler switch statement: validates xcodeproj param and dispatches to ProjectTools.getRunDestinations.

case 'xcode_get_run_destinations':
  if (!args.xcodeproj) {
    throw new McpError(ErrorCode.InvalidParams, `Missing required parameter: xcodeproj`);
  }
  return await ProjectTools.getRunDestinations(args.xcodeproj as string, this.openProject.bind(this));

src/XcodeServer.ts:180-182 (helper)

Includes the tool in the xcodeTools array used for environment validation to ensure Xcode and osascript are available before execution.

const xcodeTools = [...buildTools, 'xcode_open_project', 'xcode_get_schemes', 'xcode_set_active_scheme', 
                   'xcode_get_run_destinations', 'xcode_get_workspace_info', 'xcode_get_projects'];
const xcresultTools = ['xcresult_browse', 'xcresult_browser_get_console', 'xcresult_summary', 'xcresult_get_screenshot', 'xcresult_get_ui_hierarchy', 'xcresult_get_ui_element', 'xcresult_list_attachments', 'xcresult_export_attachment'];

XcodeMCP