Server MCP di Mainframe Assessment Tool

Questa pagina descrive come configurare e interagire con le valutazioni di Mainframe Assessment Tool utilizzando client MCP come Gemini CLI o agenti AI tramite il Model Context Protocol (MCP). Puoi utilizzare prompt in linguaggio naturale per ottenere informazioni dettagliate sulle tue valutazioni del mainframe. Con il server MCP, puoi utilizzare gli agenti AI per eseguire operazioni di rilevamento e analisi sulle valutazioni di Mainframe Assessment Tool. Ad esempio, puoi eseguire le seguenti operazioni:

  • Elenca e visualizza le valutazioni esistenti.
  • Esplora i domini aziendali rilevati nelle tue valutazioni.
  • Cercare e filtrare le risorse in base a criteri diversi.
  • Recupera le specifiche degli asset, incluse le metriche di dipendenza e complessità.

Per ulteriori informazioni su MCP, consulta Che cos'è il Model Context Protocol (MCP)?.

Prima di iniziare

Assicurati di conoscere Mainframe Assessment Tool e di averlo già utilizzato per eseguire una valutazione.

Abilitare il server MCP

Per attivare il server MCP nell'istanza VM di Mainframe Assessment Tool, aggiungi la chiave dei metadati MAT_ENABLE_MCP e imposta il relativo valore su true eseguendo il seguente comando gcloud:

    gcloud compute instances add-metadata INSTANCE_NAME \
    --metadata=MAT_ENABLE_MCP=true \
    --zone=ZONE

Sostituisci quanto segue:

  • INSTANCE_NAME: il nome dell'istanza VM.
  • ZONE: la zona in cui si trova l'istanza VM.

Se imposti la chiave dei metadati su una VM in esecuzione, devi riavviarla affinché le modifiche diventino effettive.

Connettiti al server MCP

Puoi connetterti al server MCP utilizzando agenti AI standard che supportano le connessioni MCP tramite SSE (Server-Sent Events).

Il server MCP si trova nel percorso /mcp/ della stessa porta utilizzata per accedere alla UI di Mainframe Assessment Tool. Consulta Accedere alla VM di Mainframe Assessment Tool dal computer.

Ad esempio, per utilizzare Gemini CLI, configura il server MCP nel file di impostazioni di Gemini CLI come segue:

{
  "mcpServers": {
    "mainframe-assessment-tool": {
      "url": "http://localhost:LOCAL_PORT/mcp/"
    }
  }
}

Sostituisci quanto segue:

  • LOCAL_PORT: la porta locale utilizzata per accedere alla UI di Mainframe Assessment Tool.

Per maggiori informazioni, vedi Configurare il server MCP in settings.json.

Strumenti del server MCP

Il server MCP di Mainframe Assessment Tool fornisce strumenti che consentono agli agenti AI di recuperare i dati dalle valutazioni.

ListAssessments

Elenca tutte le valutazioni esistenti nell'istanza di Mainframe Assessment Tool. Ogni valutazione include nome, ID, descrizione e timestamp.

ListDomains

Elenca i domini per un determinato ID valutazione di Mainframe Assessment Tool. Ogni dominio include il nome, la descrizione e l'ID.

Argomenti

Nome Tipo Obbligatorio Descrizione
AssessmentId string Sì L'ID della valutazione di Mainframe Assessment Tool.

ListAssets

Elenca gli asset per un determinato ID valutazione di Mainframe Assessment Tool. Ogni asset include ID, nome, percorso, tipo e ID dominio assegnati.

Argomenti

Nome Tipo Obbligatorio Descrizione
AssessmentId string Sì L'ID della valutazione di Mainframe Assessment Tool.

FetchDomain

Recupera i dettagli del dominio per un determinato ID dominio e ID valutazione di Mainframe Assessment Tool. I dettagli del dominio includono ID, nome, descrizione e riepilogo.

Argomenti

Nome Tipo Obbligatorio Descrizione
AssessmentId string Sì L'ID della valutazione di Mainframe Assessment Tool.
DomainId string Sì L'ID del dominio di Mainframe Assessment Tool.

FetchAsset

Recupera il riepilogo delle specifiche di una risorsa per un determinato ID valutazione di Mainframe Assessment Tool. La specifica dell'asset include ID, nome, utilizzo, descrizione, grafico ETL e mappe BMS.

Argomenti

Nome Tipo Obbligatorio Descrizione
AssessmentId string Sì L'ID della valutazione di Mainframe Assessment Tool.
AssetId string Sì L'ID della risorsa Mainframe Assessment Tool.
DetailedSpec boolean No (valore predefinito: false) Se è impostata su true, la risposta include anche le specifiche del metodo con i relativi scenari di test.

FetchAssetsCyclomaticComplexity

Recupera i punteggi di complessità ciclomati per un elenco di asset per un determinato ID valutazione di Mainframe Assessment Tool.

Argomenti

Nome Tipo Obbligatorio Descrizione
AssessmentId string Sì L'ID della valutazione di Mainframe Assessment Tool.
AssetIds string[] Sì Elenco degli ID risorsa di Mainframe Assessment Tool.

Esempi di utilizzo

Di seguito sono riportati esempi di prompt in linguaggio naturale a cui un agente AI può rispondere utilizzando gli strumenti del server MCP per recuperare ed elaborare i dati di valutazione:

  • Scenario: trova programmi complessi in una valutazione.
  • Prompt utente: "Elenca i 10 programmi COBOL più complessi nella valutazione chiamata AssessmentName".

  • Scenario: trova e filtra gli asset che appartengono a un dominio aziendale.
  • Prompt utente: "Elenca tutti i job JCL correlati al dominio DomainName nell'assessment chiamato AssessmentName".

  • Scenario: recupera le dipendenze degli asset da un test.
  • Prompt utente: "Quali sono le dipendenze del job JCL JCLJobName nella valutazione chiamata AssessmentName?"