MCP-Server für das Mainframe Assessment Tool

Auf dieser Seite wird beschrieben, wie Sie Bewertungen des Mainframe Assessment Tool mithilfe von MCP-Clients wie der Gemini CLI oder KI-Agents über das Model Context Protocol (MCP) einrichten und mit ihnen interagieren. Sie können Prompts in natürlicher Sprache verwenden, um Informationen zu Ihren Mainframe-Bewertungen zu erhalten. Mit dem MCP-Server können Sie KI-Agents verwenden, um Erkennungs- und Analysevorgänge für Ihre Mainframe Assessment Tool-Bewertungen durchzuführen. Sie haben beispielsweise folgende Möglichkeiten:

  • Vorhandene Analysen auflisten und ansehen
  • Hier finden Sie die in Ihren Analysen ermittelten Unternehmensbereiche.
  • 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 die Aktivierung und Verbindung zum MCP-Server vorzubereiten:

  • Machen Sie sich mit dem Mainframe Assessment Tool vertraut. Sie müssen das Tool bereits verwendet haben, um eine Bewertung durchzuführen.
  • Erforderliche Berechtigungen erteilen: Damit der MCP-Server des Mainframe Assessment Tool aktiviert werden kann, 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, indem Sie den folgenden gcloud-Befehl ausführen:

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

Ersetzen Sie Folgendes:

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

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

Verbindung zum MCP-Server herstellen

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

Der MCP-Server befindet sich unter dem /mcp/-Pfad desselben Ports, der für den Zugriff auf die Benutzeroberfläche des Mainframe Assessment Tool verwendet wird. Weitere Informationen finden Sie unter Über Ihren Computer auf die VM des Mainframe Assessment Tool zugreifen.

Konfigurationsbeispiele

In den folgenden Abschnitten finden Sie Beispiele für die Konfiguration verschiedener KI-Agents für die Verbindung zum MCP-Server.

Ersetzen Sie LOCAL_PORT durch den lokalen Port, der für den Zugriff auf die Benutzeroberfläche des Mainframe Assessment Tool verwendet wird.

Gemini CLI

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

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

Weitere Informationen finden Sie unter MCP-Server in settings.json konfigurieren.

MCP-Server-Tools

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

ListAssessments

Listet alle Bewertungen auf, die in der Mainframe Assessment Tool-Instanz vorhanden sind. Jede Bewertung enthält ihren Namen, ihre ID, ihre Beschreibung und ihre 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 Domaindetails für eine bestimmte Domain-ID und eine bestimmte Assessment-ID des Mainframe Assessment Tool 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 Domain des Mainframe Assessment Tool.

FetchAsset

Ruft die Spezifikationsübersicht 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-Karten.

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 boolean Nein (Standard: false) Wenn diese Option auf „true“ gesetzt ist, enthält die Antwort auch Methodenspezifikationen mit ihren Testläufen.

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 Asset-IDs des Mainframe Assessment Tool.

ListBusinessRulesExtractionJobs

Listet die Business Rules-Jobs 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 Bewertungs-ID des Mainframe Assessment Tool extrahiert wurden. Diese Aktion unterstützt die Paginierung, um eine große Anzahl von Regeln zu verarbeiten.

Argumente

Name Typ Erforderlich Beschreibung
AssessmentId String Ja Die ID der Mainframe Assessment Tool-Bewertung.
JobId String Ja Die ID des Jobs zum Extrahieren 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. Sehen Sie sich die Beschreibungen der einzelnen Felder an.
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 Bestellung. Unterstützte Werte: ASCENDING, DESCENDING.
Filter Objekt Nein Die zurückgegebenen Ergebnisse filtern. Sehen Sie sich die Beschreibungen der einzelnen Felder an.
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 Asset-IDs des Mainframe Assessment Tool, die mit den Geschäftsregeln verknüpft sind.

Anwendungsbeispiele

Hier sind Beispiele für Prompts in natürlicher Sprache, die ein KI-Agent beantworten kann, indem er die MCP-Servertools zum Abrufen und Verarbeiten von Bewertungsdaten verwendet:

  • Szenario: Komplexe Programme in einer Bewertung finden.
  • Nutzer-Prompt: „Liste die zehn komplexesten COBOL-Programme in der Bewertung mit dem Namen AssessmentName auf.“

  • Szenario: Assets suchen und filtern, die zu einer Unternehmensdomain gehören.
  • Nutzer-Prompt: „Liste alle JCL-Jobs auf, die sich auf die Domain DomainName in der Bewertung mit dem Namen AssessmentName beziehen.“

  • Szenario: Asset-Abhängigkeiten aus einer Bewertung abrufen
  • Nutzer-Prompt: „What are the dependencies of the JCL job JCLJobName in the assessment called AssessmentName?“ (Welche Abhängigkeiten hat der JCL-Job JCLJobName in der Bewertung mit dem Namen AssessmentName?)

  • Szenario: Extrahierte Geschäftsregeln aus einem bestimmten Job finden.
  • Nutzer-Prompt: „Liste alle Geschäftsregeln auf, die von BusinessRuleJobName in der Analyse mit dem Namen AssessmentName extrahiert wurden.“