MCP-Server für das Mainframe Assessment Tool aktivieren

Auf dieser Seite wird beschrieben, wie Sie den MCP-Server des Mainframe Assessment Tool einrichten und verwenden. Sie können mit Prompts in natürlicher Sprache Geschäftsdomains untersuchen, nach Assets suchen und Komplexitätsmesswerte aus Ihren Mainframe-Bewertungen abrufen. Wenn Sie mit dem MCP-Server interagieren möchten, stellen Sie über KI-Agenten oder MCP-Clients (Model Context Protocol) wie die Gemini CLI eine Verbindung her.

Sie haben zum Beispiel folgende Möglichkeiten:

  • Vorhandene Bewertungen auflisten und ansehen.
  • Geschäftsdomains untersuchen, die in Ihren Bewertungen gefunden wurden.
  • Assets anhand verschiedener Kriterien suchen und filtern.
  • Asset-Spezifikationen abrufen, einschließlich Abhängigkeiten und Komplexitätsmesswerten.

Weitere Informationen zum MCP finden Sie unter Was ist das Model Context Protocol (MCP)?.

Hinweis

Führen Sie die folgenden Aufgaben aus, um sich auf die Aktivierung und Verbindung mit dem MCP-Server vorzubereiten:

  • Machen Sie sich mit dem Mainframe Assessment Tool vertraut. Sie müssen das Mainframe Assessment Tool bereits verwendet haben, um eine Bewertung durchzuführen.
  • Erforderliche Berechtigungen gewähren. Um den MCP-Server des Mainframe Assessment Tool zu aktivieren, benötigen Sie Berechtigungen zum Festlegen benutzerdefinierter Metadaten für Ihre VM-Instanzen. Weitere Informationen zu den erforderlichen Rollen und Berechtigungen finden Sie unter Benutzerdefinierte Metadaten festlegen und entfernen.
  • Google Cloud CLI einrichten. Installieren und konfigurieren Sie die neueste Version der Google Cloud CLI. Weitere Informationen finden Sie unter Google Cloud CLI installieren.

MCP-Server aktivieren

Wenn Sie den MCP-Server auf Ihrer VM-Instanz des Mainframe Assessment Tool aktivieren möchten, fügen Sie den Metadatenschlüssel MAT_ENABLE_MCP hinzu und legen Sie seinen Wert auf true fest. Führen Sie dazu den folgenden gcloud-Befehl aus:

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

Ersetzen Sie Folgendes:

  • INSTANCE_NAME: der Name Ihrer VM-Instanz.
  • ZONE: die Zone, in der sich Ihre VM-Instanz befindet.

Wenn Sie den Metadatenschlüssel auf einer ausgeführten VM festlegen, müssen Sie die VM neu starten, damit die Änderungen übernommen werden.

Verbindung zum MCP-Server herstellen

Sie können eine Verbindung zum MCP-Server mit Standard-KI-Agenten herstellen, die MCP-Verbindungen über Streamable HTTP unterstützen.

Der MCP-Server befindet sich unter der Route /mcp/ desselben Ports, der für den Zugriff auf die Mainframe Assessment Tool-UI verwendet wird. Weitere Informationen finden Sie unter Zugriff auf die Mainframe Assessment Tool-VM von Ihrem Computer aus.

Konfigurationsbeispiele

In den folgenden Abschnitten finden Sie Beispiele für die Konfiguration verschiedener KI-Agenten, um eine Verbindung zum MCP-Server herzustellen.

Ersetzen Sie LOCAL_PORT durch den lokalen Port, der für den Zugriff auf die Mainframe Assessment Tool-UI verwendet wird.

Gemini CLI

Wenn Sie Gemini CLI verwenden möchten, konfigurieren Sie den MCP-Server in der Einstellungsdatei der Gemini CLI so:

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

Weitere Informationen finden Sie unter MCP-Server in der Datei „settings.json“ konfigurieren.

MCP-Servertools

Der MCP-Server des Mainframe Assessment Tool bietet Tools, mit denen KI-Agenten Daten aus Ihren Bewertungen abrufen können.

ListAssessments

Listet alle Bewertungen in der Mainframe Assessment Tool-Instanz auf. Jede Bewertung enthält ihren Namen, ihre ID, ihre Beschreibung und Zeitstempel.

ListDomains

Listet die Domains für eine bestimmte Mainframe Assessment Tool-Bewertungs-ID auf. Jede Domain enthält ihren Namen, ihre Beschreibung und ihre ID.

Argumente

Name Typ Erforderlich Beschreibung
AssessmentId String Ja Die ID der Mainframe Assessment Tool-Bewertung.

ListAssets

Listet die Assets für eine bestimmte Mainframe Assessment Tool-Bewertungs-ID auf. Jedes Asset enthält seine ID, seinen Namen, seinen Pfad, seinen Typ und die zugewiesenen Domain-IDs.

Argumente

Name Typ Erforderlich Beschreibung
AssessmentId String Ja Die ID der Mainframe Assessment Tool-Bewertung.

FetchDomain

Ruft die Details der Domain für eine bestimmte Domain-ID und Mainframe Assessment Tool-Bewertungs-ID ab. Zu den Domaindetails gehören ID, Name, Beschreibung und Zusammenfassung.

Argumente

Name Typ Erforderlich Beschreibung
AssessmentId String Ja Die ID der Mainframe Assessment Tool-Bewertung.
DomainId String Ja Die ID der Mainframe Assessment Tool-Domain.

FetchAsset

Ruft die Spezifikationszusammenfassung für ein Asset für eine bestimmte Mainframe Assessment Tool-Bewertungs-ID ab. Die Asset-Spezifikation enthält die ID, den Namen, die Verwendung, die Beschreibung, das ETL-Diagramm und die BMS-Zuordnungen.

Argumente

Name Typ Erforderlich Beschreibung
AssessmentId String Ja Die ID der Mainframe Assessment Tool-Bewertung.
AssetId String Ja Die ID des Mainframe Assessment Tool-Assets.
DetailedSpec Boolesch Nein (Standard: false) Wenn auf „true“ gesetzt ist, enthält die Antwort auch Methodenspezifikationen mit ihren Testfällen.

FetchAssetsCyclomaticComplexity

Ruft die Werte für die zyklomatische Komplexität für eine Liste von Assets für eine bestimmte Mainframe Assessment Tool-Bewertungs-ID ab.

Argumente

Name Typ Erforderlich Beschreibung
AssessmentId String Ja Die ID der Mainframe Assessment Tool-Bewertung.
AssetIds String[] Ja Liste der Mainframe Assessment Tool-Asset-IDs.

SearchContent

Durchsucht Quellcode, KI-generierte Spezifikationen und Geschäftsregeln in einer bestimmten Mainframe-Bewertung. Es werden schlüsselwortbasierte (bm25), semantische (embedding) und hybride (hybrid) Suchmodi unterstützt, mit denen Nutzer relevante Assets und Dokumentationen finden können.

Mit dem Tool können Ergebnisse nach Dokumenttyp (source, spec oder bre) gefiltert, die Anzahl der zurückgegebenen Treffer begrenzt und optional der vollständige Inhalt übereinstimmender Dokumente abgerufen werden.

Argumente

Name Typ Erforderlich Beschreibung
AssessmentId String Ja Die ID der Mainframe Assessment Tool-Bewertung.
Query String Ja Die Suchanfrage.
DocTypes String[] Nein Ergebnisse nach Dokumenttyp filtern. Unterstützte Werte: source, spec oder bre.
Limit Integer Nein Anzahl der zurückgegebenen Treffer begrenzen.
IncludeContent Boolesch Nein Wenn auf „true“ gesetzt, enthält die Antwort auch den vollständigen Inhalt von übereinstimmenden Dokumenten. Der Standardwert ist false.
SearchMode String Nein Der zu verwendende Suchmodus. Unterstützte Werte: bm25 (schlüsselwortbasiert), embedding (semantisch) oder hybrid. Der Standardwert ist hybrid.

ExploreData

Führt einen interaktiven KI-Agenten (Data Explorer) aus, der als Datenanalyst für Ihre Bewertung fungiert. Der Agent kann die zugrunde liegende strukturierte Datenbank einer bestimmten Bewertung abfragen, um komplexe Fragen zu beantworten.

Argumente

Name Typ Erforderlich Beschreibung
AssessmentId String Ja Die ID der Mainframe Assessment Tool-Bewertung.
Query String Ja Die Frage oder Abfrage zur Datenexploration.

ListBusinessRulesExtractionJobs

Listet die Jobs für Geschäftsregeln für eine bestimmte Mainframe Assessment Tool-Bewertungs-ID auf. Die zurückgegebene Liste enthält die ID, den Namen, den Status, den Fokus-Prompt und weitere Informationen zu jedem Job.

Argumente

Name Typ Erforderlich Beschreibung
AssessmentId String Ja Die ID der Mainframe Assessment Tool-Bewertung.

ListBusinessRules

Listet die Geschäftsregeln auf, die von einer bestimmten Job-ID für die Extraktion von Geschäftsregeln und einer bestimmten Mainframe Assessment Tool-Bewertungs-ID extrahiert wurden. Um die große Anzahl von Regeln zu verarbeiten, unterstützt diese Aktion die Paginierung.

Argumente

Name Typ Erforderlich Beschreibung
AssessmentId String Ja Die ID der Mainframe Assessment Tool-Bewertung.
JobId String Ja Die ID des Jobs für die Extraktion von Geschäftsregeln.
PageSize String Nein Die Größe der abzurufenden Seite. Der maximal unterstützte Wert ist `25`.
PageToken String Nein Das Token der abzurufenden Seite. Dieser Wert wurde von einem vorherigen Aufruf dieser Aktion zurückgegeben.
OrderList Objekt Nein Die Reihenfolge, in der die Ergebnisse zurückgegeben werden sollen. Weitere Informationen finden Sie in den Beschreibungen der einzelnen Felder.
OrderList.OrderBy String Nein Der Name des Felds, nach dem die Ergebnisse sortiert werden sollen. Beispiele: business_rule_id, business_rule_name, status.
OrderList.Order String Nein Die Richtung der Sortierung. Unterstützte Werte: ASCENDING, DESCENDING.
Filter Objekt Nein Die zurückgegebenen Ergebnisse filtern. Weitere Informationen finden Sie in den Beschreibungen der einzelnen Felder.
Filter.Status String Nein Der Status der Geschäftsregeln, nach dem gefiltert werden soll. Unterstützte Werte: PENDING, VALIDATED, OBSOLETE.
Filter.Tags String[] Nein Liste der mit den Geschäftsregeln verknüpften Tags.
Filter.AssetIDs String[] Nein Liste der Mainframe Assessment Tool-Asset-IDs, die mit den Geschäftsregeln verknüpft sind.

Anwendungsbeispiele

Im Folgenden finden Sie Beispiele für Prompts in natürlicher Sprache, die ein KI-Agent beantworten kann, indem er die MCP-Servertools verwendet, um Bewertungsdaten abzurufen und zu verarbeiten:

  • Szenario: Komplexe Programme in einer Bewertung finden.
  • Nutzer-Prompt: "List the 10 most complex COBOL programs in the assessment called AssessmentName."

  • Szenario: Assets finden und filtern, die zu einer Geschäftsdomain gehören.
  • Nutzer-Prompt: "List all the JCL jobs related to the DomainName domain under the assessment called AssessmentName."

  • Szenario: Asset-Abhängigkeiten aus einer Bewertung abrufen.
  • Nutzer-Prompt: "What are the dependencies of the JCL job JCLJobName in the assessment called AssessmentName?"

  • Szenario: Die extrahierten Geschäftsregeln aus einem bestimmten Job finden.
  • Nutzer-Prompt: "List all business rules extracted by BusinessRuleJobName in the assessment called AssessmentName."

  • Szenario: Bewertungsdaten in natürlicher Sprache untersuchen.
  • Nutzer-Prompt: "Explain how the data processing flow works for the billing system in the assessment called AssessmentName."