XcodeMCP

Instructions

Implementation Reference

• src/tools/BuildTools.ts:1210-1222 (handler)

  Core handler function that executes the JXA script to invoke Xcode's workspace.stop() method, stopping the current build/run/test action.

  public static async stop(projectPath: string): Promise<McpResult> {
    const script = `
      (function() {
        ${getWorkspaceByPathScript(projectPath)}
        
        workspace.stop();
        return 'Stop command sent';
      })()
    `;
    
    const result = await JXAExecutor.execute(script);
    return { content: [{ type: 'text', text: result }] };
  }

• src/XcodeServer.ts:479-483 (handler)

  MCP server dispatch handler in CallToolRequestSchema switch statement that validates input and delegates to BuildTools.stop.

  case 'xcode_stop':
    if (!args.xcodeproj) {
      return { content: [{ type: 'text', text: 'Error: xcodeproj parameter is required' }] };
    }
    return await BuildTools.stop(args.xcodeproj as string);

• src/shared/toolDefinitions.ts:217-232 (schema)

  Tool schema definition providing name, description, and input validation schema (requires xcodeproj path).

  {
    name: 'xcode_stop',
    description: 'Stop the current scheme action 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:301-319 (registration)

  Registers xcode_stop tool (via getToolDefinitions) for the MCP ListToolsRequestSchema, making it discoverable by clients.

  this.server.setRequestHandler(ListToolsRequestSchema, async () => {
    const toolOptions: {
      includeClean: boolean;
      preferredScheme?: string;
      preferredXcodeproj?: string;
    } = { includeClean: this.includeClean };
    
    if (this.preferredScheme) toolOptions.preferredScheme = this.preferredScheme;
    if (this.preferredXcodeproj) toolOptions.preferredXcodeproj = this.preferredXcodeproj;
    
    const toolDefinitions = getToolDefinitions(toolOptions);
    return {
      tools: toolDefinitions.map(tool => ({
        name: tool.name,
        description: tool.description,
        inputSchema: tool.inputSchema
      })),
    };
  });