Prompt Auto-Optimizer MCP

Instructions

Implementation Reference

• src/mcp/server.ts:1487-1532 (handler)

  Main handler function for 'gepa_restore_backup' tool. Extracts parameters, initializes disaster recovery, calls restoreSystemFromBackup on the DisasterRecoverySystem instance, formats and returns the detailed response including success status, components restored/failed, warnings, and integrity checks.

    private async restoreBackup(params: {
      backupId: string;
      validateIntegrity?: boolean;
      createPreRestoreBackup?: boolean;
    }): Promise<{ content: { type: string; text: string; }[] }> {
      const { backupId, validateIntegrity = true, createPreRestoreBackup = true } = params;
  
      try {
        await this.disasterRecovery.initialize();
        
        const result = await this.disasterRecovery.restoreSystemFromBackup(backupId, {
          validateIntegrity,
          createPreRestoreBackup
        });
  
        return {
          content: [
            {
              type: 'text',
              text: `# System Restore ${result.success ? 'Completed' : 'Failed'}
  
  ## Restore Details
  - **Backup ID**: ${result.backupId}
  - **Success**: ${result.success ? 'Yes' : 'No'}
  - **Restore Time**: ${result.restoreTime} ms
  - **Pre-restore Backup**: ${result.preRestoreBackupId || 'None created'}
  
  ## Components Restored
  ${result.restoredComponents.map(comp => `✅ ${comp}`).join('\n')}
  
  ${result.failedComponents.length > 0 ? `## Failed Components
  ${result.failedComponents.map(comp => `❌ ${comp}`).join('\n')}` : ''}
  
  ${result.warnings.length > 0 ? `## Warnings
  ${result.warnings.map(w => `⚠️ ${w}`).join('\n')}` : ''}
  
  ${result.integrityChecks.length > 0 ? `## Integrity Checks
  ${result.integrityChecks.map(check => `- ${check.component}: ${check.valid ? '✅ Valid' : '❌ Invalid'}`).join('\n')}` : ''}
  
  ${result.success ? 'System has been successfully restored from backup.' : 'Restore completed with errors. Please check the failed components and warnings.'}`,
            },
          ],
        };
      } catch (error) {
        throw new Error(`Failed to restore backup: ${error instanceof Error ? error.message : 'Unknown error'}`);
      }

• src/mcp/server.ts:271-292 (schema)

  Input schema definition for the gepa_restore_backup tool, specifying parameters backupId (required), validateIntegrity, and createPreRestoreBackup.

  name: 'gepa_restore_backup',
  description: 'Restore system from a specific backup',
  inputSchema: {
    type: 'object',
    properties: {
      backupId: {
        type: 'string',
        description: 'ID of the backup to restore from'
      },
      validateIntegrity: {
        type: 'boolean',
        default: true,
        description: 'Perform integrity validation before restore'
      },
      createPreRestoreBackup: {
        type: 'boolean',
        default: true,
        description: 'Create backup before restoration'
      }
    },
    required: ['backupId']
  }

• src/mcp/server.ts:516-626 (registration)

  Tool call request handler registration in the MCP server. The switch statement dispatches 'gepa_restore_backup' calls to the restoreBackup method.

    // Handle tool calls
    this.server.setRequestHandler(CallToolRequestSchema, async (request: any) => {
      const { name, arguments: args } = request.params;
  
      try {
        if (!this.isInitialized) {
          throw new Error('GEPA components not properly initialized');
        }
  
        switch (name) {
          case 'gepa_start_evolution':
            return await this.startEvolution(args as unknown as StartEvolutionParams);
          
          case 'gepa_record_trajectory':
            return await this.recordTrajectory(args as unknown as RecordTrajectoryParams);
          
          case 'gepa_evaluate_prompt':
            return await this.evaluatePrompt(args as unknown as EvaluatePromptParams);
          
          case 'gepa_reflect':
            return await this.reflect(args as unknown as ReflectParams);
          
          case 'gepa_get_pareto_frontier':
            return await this.getParetoFrontier(args as unknown as GetParetoFrontierParams);
          
          case 'gepa_select_optimal':
            return await this.selectOptimal(args as unknown as SelectOptimalParams);
          
          // Legacy tools for backward compatibility
          case 'gepa_evolve_prompt':
            return await this.evolvePrompt(args as {
              prompt: string;
              fitness_criteria: string;
              generations?: number;
              population_size?: number;
            });
          
          case 'gepa_analyze_prompt':
            return await this.analyzePrompt(args as {
              prompt: string;
              analysis_type?: string;
            });
          
          case 'gepa_optimize_prompt':
            return await this.optimizePrompt(args as {
              prompt: string;
              optimization_target: string;
              constraints?: Record<string, unknown>;
            });
          
          case 'gepa_generate_variants':
            return await this.generateVariants(args as {
              prompt: string;
              variant_count?: number;
              strategy?: string;
            });
          
          // Disaster Recovery Tools
          case 'gepa_create_backup':
            return await this.createBackup(args as {
              label?: string;
              includeTrajectories?: boolean;
            });
          
          case 'gepa_restore_backup':
            return await this.restoreBackup(args as {
              backupId: string;
              validateIntegrity?: boolean;
              createPreRestoreBackup?: boolean;
            });
          
          case 'gepa_list_backups':
            return await this.listBackups(args as {
              limit?: number;
              filterLabel?: string;
            });
          
          case 'gepa_recovery_status':
            return await this.getRecoveryStatus(args as {
              includeMetrics?: boolean;
            });
          
          case 'gepa_recover_component':
            return await this.recoverComponent(args as {
              componentType: string;
              strategy?: string;
            });
          
          case 'gepa_integrity_check':
            return await this.performIntegrityCheck(args as {
              component?: string;
              autoRepair?: boolean;
            });
          
          default:
            throw new Error(`Unknown tool: ${name}`);
        }
      } catch (error) {
        const errorMessage = error instanceof Error ? error.message : 'Unknown error occurred';
        return {
          content: [
            {
              type: 'text',
              text: `Error executing ${name}: ${errorMessage}`,
            },
          ],
          isError: true,
        };
      }
    });
  }

• src/mcp/server.ts:510-513 (registration)

  Lists all available tools including gepa_restore_backup via the TOOLS array.

  this.server.setRequestHandler(ListToolsRequestSchema, async () => {
    return {
      tools: TOOLS,
    };