App Store Connect MCP Server

Instructions

Implementation Reference

• src/handlers/xcode.ts:18-70 (handler)

  Handler function that validates the project path, executes xcodebuild -list command, parses the output using parseXcodebuildOutput, and returns formatted scheme list.

  async listSchemes(args: ListSchemesArgs): Promise<any> {
    const { projectPath } = args;
  
    if (!projectPath) {
      throw new Error('Project path is required');
    }
  
    if (!existsSync(projectPath)) {
      throw new Error(`Project path does not exist: ${projectPath}`);
    }
  
    const stats = statSync(projectPath);
    if (!stats.isDirectory()) {
      throw new Error(`Project path is not a directory: ${projectPath}`);
    }
  
    const isWorkspace = projectPath.endsWith('.xcworkspace');
    const isProject = projectPath.endsWith('.xcodeproj');
  
    if (!isWorkspace && !isProject) {
      throw new Error('Project path must be either a .xcworkspace or .xcodeproj file');
    }
  
    try {
      const command = isWorkspace 
        ? `xcodebuild -workspace "${projectPath}" -list`
        : `xcodebuild -project "${projectPath}" -list`;
  
      const { stdout, stderr } = await execAsync(command);
  
      if (stderr && stderr.trim() !== '') {
        console.error('xcodebuild stderr:', stderr);
      }
  
      const schemes = this.parseXcodebuildOutput(stdout);
      
      return {
        content: [
          {
            type: "text",
            text: JSON.stringify({
              projectPath,
              projectType: isWorkspace ? 'workspace' : 'project',
              schemes,
              totalSchemes: schemes.length
            }, null, 2)
          }
        ]
      };
    } catch (error: any) {
      throw new Error(`Failed to list schemes: ${error.message}`);
    }
  }

• src/handlers/xcode.ts:72-105 (helper)

  Private helper method to parse xcodebuild -list output and extract scheme names and shared status.

  private parseXcodebuildOutput(output: string): SchemeInfo[] {
    const lines = output.split('\n');
    const schemes: SchemeInfo[] = [];
    let inSchemesSection = false;
  
    for (const line of lines) {
      const trimmedLine = line.trim();
      
      if (trimmedLine === 'Schemes:') {
        inSchemesSection = true;
        continue;
      }
  
      if (inSchemesSection) {
        if (trimmedLine === '' || trimmedLine.startsWith('Build Configurations:') || trimmedLine.startsWith('If no build configuration')) {
          break;
        }
  
        if (trimmedLine && !trimmedLine.startsWith('Information about project')) {
          const isShared = !trimmedLine.startsWith('    ');
          const schemeName = trimmedLine.trim();
          
          if (schemeName) {
            schemes.push({
              name: schemeName,
              isShared
            });
          }
        }
      }
    }
  
    return schemes;
  }

• src/handlers/xcode.ts:8-10 (schema)

  TypeScript interface defining the input arguments for listSchemes handler (projectPath: string).

  export interface ListSchemesArgs {
    projectPath: string;
  }

• src/index.ts:836-848 (registration)

  Tool registration in buildToolsList(): defines name 'list_schemes', description, and inputSchema matching ListSchemesArgs.

    name: "list_schemes",
    description: "List all available schemes in an Xcode project or workspace",
    inputSchema: {
      type: "object",
      properties: {
        projectPath: {
          type: "string",
          description: "Path to the Xcode project (.xcodeproj) or workspace (.xcworkspace)"
        }
      },
      required: ["projectPath"]
    }
  },

• src/index.ts:1419-1421 (registration)

  Dispatch registration in setupHandlers() switch statement: maps 'list_schemes' tool calls to xcodeHandlers.listSchemes.

  case "list_schemes":
    return { toolResult: await this.xcodeHandlers.listSchemes(args as any) };