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 approfondimenti 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:

  • 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

Per prepararti ad attivare e connetterti al server MCP, completa le seguenti attività:

  • Acquisisci familiarità con Mainframe Assessment Tool.Assicurati di aver già utilizzato questo strumento per eseguire una valutazione.
  • Concedi le autorizzazioni necessarie.Per attivare il server Mainframe Assessment ToolMCP, devi disporre delle autorizzazioni per impostare i metadati personalizzati sulle istanze VM. Per informazioni dettagliate su ruoli e autorizzazioni richiesti, vedi Imposta e rimuovi 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.

Abilita 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 HTTP in streaming.

Il server MCP si trova nel percorso /mcp/ della stessa porta utilizzata per accedere alla UI 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 alla UI 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 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 le risorse per un determinato ID valutazione dello strumento Mainframe Assessment Tool. Ogni risorsa include il relativo 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ì 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 dello strumento 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.

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 trovare 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 è impostata 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 (basato su parole chiave), embedding (semantico) o hybrid. Il valore predefinito è hybrid.

ExploreData

Esegue un agente AI interattivo (Data Explorer) che funge da analista di dati per la tua valutazione. L'agente può eseguire query sul database strutturato sottostante di un test specifico 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 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 di business estratte da un determinato ID job di estrazione delle regole di business e ID valutazione di Mainframe Assessment Tool. Per gestire una grande quantità di regole, questa azione supporta l'impaginazione.

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 Le dimensioni 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 dei tag associati alle regole aziendali.
Filter.AssetIDs string[] No Elenco degli ID risorsa di Mainframe Assessment Tool associati alle regole di business.

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?"

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

  • Scenario: esplora i dati di valutazione utilizzando il linguaggio naturale.
  • Prompt utente: "Spiega come funziona il flusso di trattamento dei dati per il sistema di fatturazione nel test chiamato AssessmentName".