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 Ermittlungs- 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)?.

Hinweise

Sie müssen mit dem Mainframe Assessment Tool vertraut sein und es bereits für eine Bewertung verwendet haben.

MCP-Server aktivieren

Wenn Sie den MCP-Server auf Ihrer VM-Instanz für das 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 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 SSE (Server-Sent Events) 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.

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

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

Ersetzen Sie Folgendes:

  • LOCAL_PORT: Der lokale Port, der für den Zugriff auf die Benutzeroberfläche des Mainframe Assessment Tool verwendet wird.

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 MAT-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 MAT-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 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 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 umfasst 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.

Anwendungsbeispiele

Hier sind Beispiele für Prompts in natürlicher Sprache, die ein KI-Agent beantworten kann, indem er die MCP-Server-Tools 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?)