Server MCP di Mainframe Assessment Tool

Questa pagina descrive come configurare e interagire con le valutazioni di Mainframe Assessment Tool by utilizzando i client MCP, come Gemini CLI o gli agenti AI tramite il Model Context Protocol (MCP). Puoi utilizzare prompt in linguaggio naturale per ottenere informazioni sulle 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:

  • Elencare e visualizzare le valutazioni esistenti.
  • Esplorare i domini aziendali rilevati nelle valutazioni.
  • Cercare e filtrare le risorse in base a criteri diversi.
  • Recuperare le specifiche delle risorse, incluse le metriche di dipendenza e 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 a 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 abbiano effetto.

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 saperne di più, 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 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 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 le risorse per un determinato ID di valutazione di Mainframe Assessment Tool. Ogni risorsa include l'ID, il nome, il percorso, il tipo e gli ID dei domini 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 una risorsa per un determinato ID di valutazione di Mainframe Assessment Tool. Le specifiche della risorsa 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 della risorsa 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 casi di test.

FetchAssetsCyclomaticComplexity

Recupera i punteggi di complessità ciclomati per un elenco di risorse 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 delle risorse di Mainframe Assessment Tool.

SearchContent

Esegue ricerche nel codice sorgente, nelle specifiche generate dall'AI e nelle regole aziendali all'interno di una valutazione del mainframe specifica. Supporta le modalità di ricerca basate su parole chiave (bm25), semantiche (embedding) e ibride (hybrid), consentendo agli utenti di individuare risorse 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.

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 focus 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 determinato ID di job di estrazione delle regole aziendali e dall'ID di valutazione di Mainframe Assessment Tool. Per gestire una grande quantità 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 dei singoli campi.
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 dei singoli campi.
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 dei tag associati alle regole aziendali.
Filter.AssetIDs string[] No Elenco degli ID delle risorse di Mainframe Assessment Tool associati alle regole aziendali.

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 le risorse appartenenti a un dominio aziendale.
  • Prompt utente: "Elenca tutti i job JCL relativi al dominio DomainName nella valutazione denominata AssessmentName."

  • Scenario: ottenere le dipendenze delle risorse 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?"