Esegui migrazioni con AWS Trasforma il server MCP

Il server AWS Transform Model Context Protocol (MCP) ti consente di pianificare ed eseguire migrazioni da qualsiasi MCP-compatible client, come Kiro, Claude Code, Cursor o Cline, senza uscire dall'ambiente di sviluppo. MCP è un'interfaccia standardizzata che offre all'assistente AI del cliente un accesso contestuale e in tempo reale agli spazi di lavoro e ai lavori Transform. AWS Con essa, puoi creare spazi di lavoro, avviare processi di migrazione, rispondere a attività di tipo «human-in-the-loop» e scaricare artefatti tramite il linguaggio naturale.

Il server MCP espone l'intero ciclo di vita della migrazione: individuazione dell'ambiente di origine, pianificazione della migrazione, connessione delle destinazioni, migrazione della rete, configurazione delle landing zone e rehosting del server. Account AWS Funziona come un processo locale avviato dal client MCP e comunica con Transform tramite HTTPS in uscita. AWS Il client MCP è il processo che esegue il server, come Kiro o Claude Code. L'assistente AI è l'esperienza modello di quel client a cui invii i prompt. Per un'introduzione generale agli strumenti di sviluppo AWS Transform, tra cui Kiro Power, i plugin per agenti e il plug-in IDE, consulta. Strumenti per sviluppatori

Installazione del server MCP

I plugin Kiro Power e Agent installano automaticamente il server MCP. Installa il server MCP manualmente solo se desideri utilizzarlo senza un plugin Kiro Power o un agente.

Configurazione del AWS Trasforma il server MCP

Prima di iniziare, assicurati di disporre di:

• Python 3.10 o successivo.

• Un account AWS Transform con accesso da tenant. Per informazioni sulla configurazione di AWS Transform, consultaNozioni di base su AWS Trasformazione.

• Un MCP-compatible client, come Kiro, Claude Code, Claude Desktop, Cursor o Cline.

Installa il server MCP

È possibile installare il server AWS Transform MCP da awslabs.aws-transform-mcp-server PyPI come. Gli esempi seguenti eseguono il server con. uvx

Codice Claude

claude mcp add awslabs.aws-transform-mcp-server -- uvx awslabs.aws-transform-mcp-server@latest

Kiro, Cursor, VS Code, Cline e Claude Desktop () macOS/Linux

Aggiungi quanto segue al file di configurazione MCP del tuo cliente. Per Kiro, usa. ~/.kiro/settings/mcp.json

{
  "mcpServers": {
    "awslabs.aws-transform-mcp-server": {
      "command": "uvx",
      "args": ["awslabs.aws-transform-mcp-server@latest"],
      "env": {
        "AWS_REGION": "us-east-1",
        "FASTMCP_LOG_LEVEL": "ERROR"
      }
    }
  }
}

Windows

{
  "mcpServers": {
    "awslabs.aws-transform-mcp-server": {
      "command": "uvx",
      "args": [
        "--from",
        "awslabs.aws-transform-mcp-server@latest",
        "awslabs.aws-transform-mcp-server.exe"
      ],
      "env": {
        "FASTMCP_LOG_LEVEL": "ERROR",
        "AWS_REGION": "us-east-1"
      },
      "disabled": false
    }
  }
}

Per i dettagli di configurazione per il tuo client MCP specifico, consulta il README di aws-transform-mcp-server su. GitHub

Configura le variabili di ambiente

È possibile impostare le seguenti variabili di ambiente nel env blocco della configurazione del client MCP.

Variabile	Description
AWS_REGION	Regione AWS Viene utilizzato per le chiamate API del piano di controllo. L'impostazione predefinita è la regione del profilo e quindi gli Stati Uniti orientali (Virginia settentrionale).
AWS_PROFILE	Il profilo di credenziali utilizzato per gli strumenti del piano di controllo. Se non è impostato, rientra nella catena di credenziali standard.
FASTMCP_LOG_LEVEL	Il livello di registro (DEBUG, INFOWARNING, oERROR). L’impostazione predefinita è INFO.
AWS_TRANSFORM_MCP_WRITE_DIR	La directory di base in cui sono limitati i download degli artefatti. Un percorso di download deve essere risolto all'interno di questa directory. Se il client avvia il server all'esterno di una shell, imposta questa variabile in modo che i download degli artefatti abbiano una destinazione valida.

Autenticazione

La maggior parte degli strumenti MCP utilizza l'autenticazione tramite API Web (accesso tramite browser). Lo accept_connector strumento richiede anche AWS credenziali, che il server rileva automaticamente. AWS Transform supporta i seguenti metodi di autenticazione.

IAM Identity Center (SSO)

Chiedi all'assistente AI di «Configurare AWS Transform with SSO». L'assistente richiede l'URL di avvio del tuo IAM Identity Center e apre il browser per accedere. Il server salva quindi le credenziali localmente e le carica automaticamente al riavvio. Re-run questa configurazione quando gli strumenti restituiscono errori di autenticazione.

Ruolo IAM

L'ambiente fornisce automaticamente AWS le credenziali. Imposta AWS_PROFILE nella configurazione del client MCP per selezionare un profilo specifico.

Per ulteriori informazioni sulla configurazione dell'autenticazione per AWS Transform, consultate i prerequisiti descritti più avanti in questo argomento.

Verifica la connessione

Dopo aver installato e configurato il server, riavviate il client MCP. Quindi chiedi all'assistente AI di «Verifica lo stato della mia connessione AWS Transform». Una risposta corretta conferma che il server è installato, configurato e autenticato.

Utilizzo AWS Transform per le migrazioni tramite MCP

Con il server MCP connesso, gestisci la migrazione parlando con l'assistente AI in linguaggio naturale. L'assistente chiama gli strumenti AWS Transform MCP per tuo conto per gestire gli spazi di lavoro, avviare processi di migrazione, rispondere alle attività umane in corso e recuperare artefatti. Una migrazione tipica segue queste fasi.

Per eseguire una migrazione tramite il server MCP

1. Crea o seleziona un'area di lavoro. Un workspace è un contenitore logico per uno o più processi di migrazione. L'area di lavoro determina Regione AWS dove risiedono i lavori, i dati di scoperta e i consigli di AWS Transform. Chiedi all'assistente di creare un'area di lavoro o di elencare le aree di lavoro esistenti.

2. Crea e avvia un processo di migrazione. Chiedi all'assistente di creare un lavoro di migrazione. L'assistente scopre gli agenti disponibili e avvia il lavoro. Per informazioni sui tipi di job di migrazione e sui passaggi che ciascuno include, consultaTipi di Job.

3. Esegui il rilevamento. Carica l'inventario dei server locali in modo che AWS Transform possa analizzarlo, deduplicarlo e convalidarlo. Per le fonti e i formati di dati di discovery supportati, consulta. Scopri i dati di origine

4. Crea il piano di migrazione. Collabora con l'assistente per definire e analizzare il tuo inventario, raggruppare i server in applicazioni, generare gruppi di spostamenti e creare ondate di migrazione. Puoi porre domande sul tuo ambiente e modificare il piano in qualsiasi momento. Per ulteriori informazioni, consulta Crea un piano di migrazione.

5. Connect il tuo account di destinazione. Crea un connettore e chiedi a un amministratore della destinazione di Account AWS approvarlo in modo che AWS Transform possa implementare l'infrastruttura, migrare le reti e riospitare i server. Per ulteriori informazioni, consulta Connect target Account AWS s e regioni.

6. Esegui la migrazione della rete, crea la landing zone e riospita i server. Chiedi all'assistente di eseguire le fasi di esecuzione rimanenti del tuo piano di lavoro.

7. Rispondi alle attività di tipo «human-in-the-loop». AWS Trasforma le pause nei punti di revisione e approvazione. L'assistente mostra l'attività e il relativo artefatto in modo che tu possa esaminarli. Dopo aver deciso, l'assistente invia la risposta (approva, rifiuta o invia per approvazione). Controlla sempre i dettagli dell'attività e l'elemento dell'agente prima di approvare.

8. Tieni traccia dello stato e scarica gli artefatti. Chiedi all'assistente lo stato del lavoro in qualsiasi momento e fagli scaricare elementi come report, diagrammi e riepiloghi dell'area di lavoro nel tuo ambiente locale.

Poiché interagisci con AWS Transform in modo colloquiale, puoi passare da una fase all'altra in modo iterativo, porre domande chiarificatrici e perfezionare il tuo piano senza cambiare strumento.

Best practice

Segui queste best practice quando esegui migrazioni tramite il server Transform MCP. AWS

• Esamina prima di approvare. Esamina sempre i dettagli dell'attività e l'elemento dell'agente prima di approvare un'attività umana nel ciclo. Non lasciare che l'assistente invii automaticamente le approvazioni per le fasi di migrazione che creano o AWS modificano risorse.

• Utilizza credenziali con privilegi minimi. Configura la variabile di AWS_PROFILE ambiente in modo che punti a un profilo che si riferisce solo alle autorizzazioni richieste dalla migrazione. Per le migrazioni con più account, preferisci un account Amministratore delegato rispetto all'account di gestione dell'organizzazione. Per ulteriori informazioni, consulta Utilizzo di un account amministratore delegato.

• Limita i download degli artefatti. Imposta la variabile di AWS_TRANSFORM_MCP_WRITE_DIR ambiente su una directory dedicata in modo che gli artefatti scaricati arrivino in una posizione nota e contenuta. Ciò è particolarmente importante quando un client desktop o IDE avvia il server all'esterno di una shell.

• Mantieni la sessione autenticata. I token SSO scadono. Re-run Configurazione SSO quando gli strumenti iniziano a restituire errori di autenticazione e verifica la connessione con un controllo dello stato prima di iniziare passaggi di lunga durata.

• Imposta la regione corretta. Imposta AWS_REGION Regione AWS dove risiedono l'area di lavoro e i dati di rilevamento. Se la regione di destinazione della migrazione è diversa dalla regione di scoperta, alcuni dati vengono trasferiti all'altra. Regioni AWS Per ulteriori informazioni, consulta Regioni target supportate.

• Carica dati di discovery completi e aggiornati. La qualità del piano di migrazione dipende dalla qualità dell'inventario. Carica i dati più dettagliati disponibili e verifica che riflettano il tuo ambiente attuale prima di creare ondate.

• Prendi in considerazione la modalità esperto per migrazioni di grandi dimensioni. Se vuoi ridurre al minimo le interruzioni, fornisci i tuoi dati in anticipo e lascia che l'agente li applichi automaticamente. Per ulteriori informazioni, consulta Usa la modalità esperto.

Prompt di esempio

L'esecuzione di AWS Transform tramite il server MCP non si limita a spostare l'esperienza web nell'IDE. L'assistente AI concatena più chiamate allo strumento, legge e scrive file nell'area di lavoro locale e applica la logica condizionale. Di conseguenza, puoi esprimere flussi di lavoro in più fasi, iterativi e in batch che vanno oltre una singola interazione con l'applicazione Web. Gli esempi seguenti mostrano istruzioni sofisticate. Adattali al tuo ambiente.

Cicli di verifica e monitoraggio

Fai in modo che l'assistente effettui un sondaggio, reagisca a ciò che rileva e metta in pausa per te solo quando è necessaria una decisione. Un loop autonomo come questo è gestito dall'assistente, non dall'applicazione web.

Start network migration for wave 1, then poll the job status every two
minutes until it completes or needs my input. If a human-in-the-loop task
appears, stop polling, summarize the task and its artifact for me, and wait
for my decision before doing anything else.

Check every active job across all my workspaces. For each one, give me a
one-line status, and flag any job that has been waiting on an approval for
more than 24 hours or has reported an error. Repeat this check every 15
minutes and only message me when something changes.

Re-run the inventory readiness check after my latest upload. If there are any
data-quality errors, list the affected servers grouped by issue and stop. If
it validates cleanly, proceed to application grouping using the rules in
./planning/grouping-rules.md.

Rapporti che combinano dati di valutazione e pianificazione

Chiedi all'assistente di incrociare gli artefatti provenienti da diverse fasi e di sintetizzare un rapporto consolidato. L'assistente può quindi salvarlo nell'area di lavoro locale per la revisione o il controllo della versione.

Pull my migration strategy (7Rs) recommendations and my current wave plan.
Cross-reference them and produce a consolidated readiness report that
highlights every application whose recommended strategy conflicts with the
strategy assigned to its wave. Include the confidence score and reasoning for
each conflict, and save the report to ./reports/readiness.md.

Build an executive migration report that combines my risk assessment scores,
the 7Rs recommendations, and the wave schedule. Rank waves by combined risk,
call out the top five applications that need attention before cutover, and
export it as both a PDF for stakeholders and a PPTX deck for my review.

Compare the assessment I ran last month with my current plan. Tell me which
servers were newly discovered, which changed operating system or strategy, and
which moved between waves. Write the diff to ./reports/plan-change-log.md.

Per-application diagrammi e generazione di batch

Esegui un'iterazione sulle applicazioni o sulle ondate del tuo piano e genera un artefatto per ciascuna, salvandole localmente in un unico passaggio.

For each application in my plan, generate an application dependency diagram
and save it to ./diagrams/APP_NAME.html. When you finish, give me a table of
every application with the number of dependencies found, and list any
applications you could not generate a diagram for and why.

For each wave, generate a network topology diagram scoped to that wave's
servers plus their cross-wave dependencies, and save each one to
./diagrams/waves/wave-N.html. Highlight any dependency that crosses a wave
boundary, since those need sequencing attention.

Local-environment integrazione

Combina AWS Transform con file e strumenti nel tuo ambiente di sviluppo locale, cosa che l'applicazione web non può fare.

Read the decommissioning list in ./exclusions.csv, remove every matching
server from migration scope, then rebuild my waves and show me what changed in
the plan as a result.

Read the tagging standard in ./standards/tagging.md and apply it as the
resource tagging configuration for network migration and server rehost. Show
me the resulting tag set and flag any required tag the standard does not
specify a value for.

Download the workspace summary and the 7Rs report, commit them to the
migration-artifacts git repo in this workspace under ./artifacts/$(date +%F)/,
and write a short changelog entry describing what changed since the last
snapshot.

Automazione condizionale e controllata

Accelera le procedure di approvazione e le ramificazioni in modo che l'assistente avanzi la migrazione solo quando le condizioni sono soddisfatte.

Walk my end-to-end job through discovery and planning in expert mode using the
inputs in ./planning/inputs.txt. Pause for my review after wave planning
completes. Do not connect any target account or start execution until I
explicitly approve.

For wave 1 only, connect the target account, migrate the network, and rehost
the servers. After each step, verify it succeeded before starting the next. If
any step fails or produces a warning, stop immediately, show me the details,
and do not touch waves 2 or 3.