MCP-Server für das Mainframe Assessment Tool

Auf dieser Seite wird beschrieben, wie Sie Mainframe Assessment Tool-Bewertungen mit MCP-Clients wie der Gemini CLI oder KI-Agenten über das Model Context Protocol (MCP) einrichten und verwenden. Sie können Prompts in natürlicher Sprache verwenden, um Einblicke in Ihre Mainframe Assessment Tool-Bewertungen zu erhalten. Mit dem MCP-Server können Sie KI-Agenten verwenden, um Ermittlungs- und Analysevorgänge für Ihre Mainframe Assessment Tool-Bewertungen auszuführen. Beispielsweise können Sie Folgendes tun:

  • Vorhandene Bewertungen auflisten und ansehen.
  • In Ihren Bewertungen ermittelte Geschäftsdomains untersuchen.
  • Assets nach verschiedenen Kriterien suchen und filtern.
  • Asset-Spezifikationen abrufen, einschließlich Abhängigkeiten und Komplexitätsmesswerte.

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

Hinweis

Sie sollten mit dem Mainframe Assessment Tool vertraut sein und es bereits für die Ausführung einer Bewertung verwendet haben.

MCP-Server aktivieren

Wenn Sie den MCP-Server auf Ihrer Mainframe Assessment Tool-VM-Instanz aktivieren möchten, fügen Sie den Metadatenschlüssel MAT_ENABLE_MCP hinzu und setzen Sie seinen Wert auf true. 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 aktiven 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-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 Auf Mainframe Assessment Tool-VM von Ihrem Computer aus zugreifen.

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.

Antigravity-IDE

Wenn Sie Antigravity-IDE verwenden möchten, konfigurieren Sie den benutzerdefinierten MCP-Server in der Datei „mcp_config.json“ so:

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

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 auf, die in der Mainframe Assessment Tool-Instanz vorhanden sind. 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 Details der Domain 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 boolean Nein (Standard: false) Wenn auf „true“ gesetzt, 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.

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.
  • Prompt des Nutzers: "Liste die 10 komplexesten COBOL-Programme in der Bewertung mit dem Namen AssessmentName."

  • Szenario: Assets finden und filtern, die zu einer Geschäftsdomain gehören.
  • Prompt des Nutzers: "Liste alle JCL-Jobs auf, die zur Domain DomainName in der Bewertung mit dem Namen AssessmentName gehören."

  • Szenario: Asset-Abhängigkeiten aus einer Bewertung abrufen.
  • Prompt des Nutzers: "Welche Abhängigkeiten hat der JCL-Job JCLJobName in der Bewertung mit dem Namen AssessmentName?"