Abilita il server MCP di Mainframe Assessment Tool

Questa pagina descrive come configurare e interagire con il server MCP di Mainframe Assessment Tool. Puoi esplorare i domini aziendali, cercare asset e recuperare le metriche di complessità dalle valutazioni del mainframe utilizzando prompt in linguaggio naturale. Per interagire con il server MCP, connettiti tramite agenti AI o client Model Context Protocol (MCP), come Gemini CLI.

Puoi ad esempio eseguire le seguenti operazioni:

  • Elenca e visualizza le valutazioni esistenti.
  • Esplora i domini aziendali rilevati nelle tue valutazioni.
  • Cerca e filtra gli asset in base a criteri diversi.
  • Recupera le specifiche degli asset, incluse le dipendenze e le metriche di complessità.

Per saperne di più su MCP, consulta Che cos'è il Model Context Protocol (MCP)?.

Prima di iniziare

Per prepararti ad abilitare il server MCP e connetterti, completa le seguenti attività:

  • Acquisisci familiarità con Mainframe Assessment Tool. Assicurati di aver già utilizzato Mainframe Assessment Tool per eseguire una valutazione.
  • Concedi le autorizzazioni necessarie. Per abilitare il server MCP di Mainframe Assessment Tool, devi disporre delle autorizzazioni per impostare i metadati personalizzati sulle istanze VM. Per i dettagli sui ruoli e sulle autorizzazioni richiesti, consulta Impostare e rimuovere i metadati personalizzati.
  • Configura Google Cloud CLI. Installa e configura l'ultima versione di Google Cloud CLI. Per saperne di più, consulta Installare Google Cloud CLI.

Abilitare il server MCP

Per abilitare il server MCP sull'istanza VM di Mainframe Assessment Tool, aggiungi la chiave di 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 di metadati su una VM in esecuzione, devi riavviare la VM affinché le modifiche diventino effettive.

Connettersi al server MCP

Puoi connetterti al server MCP utilizzando gli agenti AI standard che supportano le connessioni MCP tramite HTTP trasmissibile.

Il server MCP si trova nel percorso /mcp/ della stessa porta utilizzata per accedere all'interfaccia utente di Mainframe Assessment Tool. Per maggiori informazioni, consulta Accedere alla VM di Mainframe Assessment Tool dal computer.

Esempi di configurazione

Le seguenti sezioni forniscono esempi di come configurare diversi agenti AI per connettersi al server MCP.

Sostituisci LOCAL_PORT: con la porta locale utilizzata per accedere all'interfaccia utente di Mainframe Assessment Tool.

Gemini CLI

Per utilizzare Gemini CLI, configura il server MCP nel file di impostazioni di Gemini CLI come segue:

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

Per saperne di più, consulta Configurare il server MCP in settings.json.

Strumenti 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 sull'istanza di Mainframe Assessment Tool. Ogni valutazione include il nome, l'ID, la descrizione e i timestamp.

ListDomains

Elenca i domini per un determinato ID di 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 di valutazione di Mainframe Assessment Tool. Ogni asset include l'ID, il nome, il percorso, il tipo e gli ID di 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 di dominio e ID di 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 un asset per un determinato ID di valutazione di Mainframe Assessment Tool. Le specifiche dell'asset includono l'ID, il nome, l'utilizzo, la descrizione, il grafico ETL e le mappe BMS.

Argomenti

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

FetchAssetsCyclomaticComplexity

Recupera i punteggi di complessità ciclomati per un elenco di asset per un determinato ID di 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 degli asset di Mainframe Assessment Tool.

SearchContent

Esegue ricerche nel codice sorgente, nelle specifiche generate dall'AI e nelle regole aziendali all'interno di una valutazione mainframe specifica. Supporta le modalità di ricerca basate su parole chiave (bm25), semantiche (embedding) e ibride (hybrid), consentendo agli utenti di individuare asset e documentazione pertinenti.

Lo strumento può filtrare i risultati per tipo di documento (source, spec o bre), limitare il numero di corrispondenze restituite e, facoltativamente, recuperare l'intero contenuto dei documenti corrispondenti.

Argomenti

Nome Tipo Obbligatorio Descrizione
AssessmentId string Sì L'ID della valutazione di Mainframe Assessment Tool.
Query string Sì La query di ricerca.
DocTypes string[] No Filtra i risultati per tipo di documento. I valori supportati sono: source, spec o bre.
Limit integer No Limita il numero di corrispondenze restituite.
IncludeContent boolean No Se è impostato su true, la risposta include anche l'intero contenuto dei documenti corrispondenti. Il valore predefinito è false.
SearchMode string No La modalità di ricerca da utilizzare. I valori supportati sono: bm25 (basata su parole chiave), embedding (semantica) o hybrid. Il valore predefinito è hybrid.

ExploreData

Esegue un agente AI interattivo (Esploratore dati) che funge da analista dei dati per la tua valutazione. L'agente può eseguire query sul database strutturato sottostante di una valutazione specifica per rispondere a domande complesse.

Argomenti

Nome Tipo Obbligatorio Descrizione
AssessmentId string Sì L'ID della valutazione di Mainframe Assessment Tool.
Query string Sì La domanda o la query per l'esplorazione dei dati.

ListBusinessRulesExtractionJobs

Elenca i job delle regole aziendali per un determinato ID di valutazione di Mainframe Assessment Tool. L'elenco restituito include l'ID, il nome, lo stato, il prompt di messa a fuoco e altro ancora di ogni job.

Argomenti

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

ListBusinessRules

Elenca le regole aziendali estratte da un ID di job di estrazione di regole aziendali specifico e da un ID di valutazione di Mainframe Assessment Tool. Per gestire il numero elevato di regole, questa azione supporta la paginazione.

Argomenti

Nome Tipo Obbligatorio Descrizione
AssessmentId string Sì L'ID della valutazione di Mainframe Assessment Tool.
JobId string Sì L'ID del job di estrazione delle regole aziendali.
PageSize string No La dimensione della pagina da recuperare. Il valore massimo supportato è `25`.
PageToken string No Il token della pagina da recuperare. Questo valore è stato restituito da una chiamata precedente a questa azione.
OrderList oggetto No L'ordine in cui restituire i risultati. Consulta le descrizioni per campo.
OrderList.OrderBy string No Il nome del campo in base al quale ordinare i risultati. Esempi: business_rule_id, business_rule_name, status.
OrderList.Order string No La direzione dell'ordine. I valori supportati sono: ASCENDING, DESCENDING.
Filter oggetto No Filtra i risultati restituiti. Consulta le descrizioni per campo.
Filter.Status string No Lo stato delle regole aziendali in base al quale filtrare. I valori supportati sono: PENDING, VALIDATED, OBSOLETE.
Filter.Tags string[] No Elenco di tag associati alle regole aziendali.
Filter.AssetIDs string[] No Elenco degli ID degli asset di Mainframe Assessment Tool associati alle regole aziendali.

FetchJobSpec

Recupera le specifiche del job di estrazione delle regole aziendali (BRE) per un ID di valutazione di Mainframe Assessment Tool.

Argomenti

Nome Tipo Obbligatorio Descrizione
AssessmentId string Sì L'ID della valutazione di Mainframe Assessment Tool.
JobId string Sì L'ID del job di estrazione delle regole aziendali (BRE).

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: trovare programmi complessi in una valutazione.
  • Prompt utente: "Elenca i 10 programmi COBOL più complessi nella valutazione denominata AssessmentName."

  • Scenario: trovare e filtrare gli asset appartenenti a un dominio aziendale.
  • Prompt utente: "Elenca tutti i job JCL relativi al dominio DomainName nella valutazione denominata AssessmentName."

  • Scenario: ottenere le dipendenze degli asset da una valutazione.
  • Prompt utente: "Quali sono le dipendenze del job JCL JCLJobName nella valutazione denominata AssessmentName?"

  • Scenario: trovare le regole aziendali estratte da un determinato job.
  • Prompt utente: "Elenca tutte le regole aziendali estratte da BusinessRuleJobName nella valutazione denominata AssessmentName."

  • Scenario: esplorare i dati di valutazione utilizzando il linguaggio naturale.
  • Prompt utente: "Spiega come funziona il flusso di elaborazione dei dati per il sistema di fatturazione nella valutazione denominata AssessmentName."