Serveur MCP Mainframe Assessment Tool

Cette page explique comment configurer et utiliser les évaluations de Mainframe Assessment Tool en utilisant des clients MCP tels que Gemini CLI ou des agents d'IA via le protocole MCP (Model Context Protocol). Vous pouvez utiliser des prompts en langage naturel pour obtenir des insights sur vos évaluations de mainframe. Avec le serveur MCP, vous pouvez utiliser des agents d'IA pour effectuer des opérations de découverte et d'analyse sur vos évaluations de Mainframe Assessment Tool. Par exemple, vous pouvez effectuer les opérations suivantes :

  • Répertorier et afficher les évaluations existantes.
  • Explorer les domaines d'activité découverts dans vos évaluations.
  • Rechercher et filtrer des éléments en fonction de différents critères.
  • Récupérer les spécifications des éléments, y compris les dépendances et les métriques de complexité.

Pour en savoir plus sur le protocole MCP, consultez Qu'est-ce que le protocole MCP (Model Context Protocol) ?.

Avant de commencer

Assurez-vous de bien connaître Mainframe Assessment Tool et de l'avoir déjà utilisé pour exécuter une évaluation.

Activer le serveur MCP

Pour activer le serveur MCP sur votre instance de VM Mainframe Assessment Tool, ajoutez la clé de métadonnées MAT_ENABLE_MCP et définissez sa valeur sur true en exécutant la commande gcloud suivante :

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

Remplacez les éléments suivants :

  • INSTANCE_NAME : nom de votre instance de VM.
  • ZONE : zone où se trouve votre instance de VM.

Si vous définissez la clé de métadonnées sur une VM en cours d'exécution, vous devez redémarrer la VM pour que les modifications soient prises en compte.

Se connecter au serveur MCP

Vous pouvez vous connecter au serveur MCP à l'aide d'agents d'IA standards compatibles avec les connexions MCP via HTTP en flux continu.

Le serveur MCP se trouve sous la route /mcp/ du même port que celui utilisé pour accéder à l'interface utilisateur de Mainframe Assessment Tool. Consultez Accéder à la VM Mainframe Assessment Tool depuis votre ordinateur.

Exemples de configuration

Les sections suivantes fournissent des exemples de configuration de différents agents d'IA pour se connecter au serveur MCP.

Remplacez LOCAL_PORT : par le port local utilisé pour accéder à l'interface utilisateur de Mainframe Assessment Tool.

Gemini CLI

Pour utiliser Gemini CLI, configurez le serveur MCP dans le fichier de paramètres de Gemini CLI comme suit :

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

Pour en savoir plus, consultez Configurer le serveur MCP dans settings.json.

IDE Antigravity

Pour utiliser l'IDE Antigravity, configurez le serveur MCP personnalisé dans mcp_config.json comme suit :

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

Outils du serveur MCP

Le serveur MCP de Mainframe Assessment Tool fournit des outils qui permettent aux agents d'IA de récupérer des données à partir de vos évaluations.

ListAssessments

Répertorie toutes les évaluations qui existent sur l'instance Mainframe Assessment Tool. Chaque évaluation inclut son nom, son ID, sa description et ses horodatages.

ListDomains

Répertorie les domaines pour un ID d'évaluation Mainframe Assessment Tool donné. Chaque domaine inclut son nom, sa description et son ID.

Arguments

Nom Type Obligatoire Description
AssessmentId chaîne Oui ID de l'évaluation Mainframe Assessment Tool.

ListAssets

Répertorie les éléments pour un ID d'évaluation Mainframe Assessment Tool donné. Chaque élément inclut son ID, son nom, son chemin d'accès, son type et les ID de domaine qui lui sont attribués.

Arguments

Nom Type Obligatoire Description
AssessmentId chaîne Oui ID de l'évaluation Mainframe Assessment Tool.

FetchDomain

Récupère les détails du domaine pour un ID de domaine et un ID d'évaluation Mainframe Assessment Tool donnés. Les détails du domaine incluent l'ID, le nom, la description et le résumé.

Arguments

Nom Type Obligatoire Description
AssessmentId chaîne Oui ID de l'évaluation Mainframe Assessment Tool.
DomainId chaîne Oui ID du domaine Mainframe Assessment Tool.

FetchAsset

Récupère le résumé des spécifications d'un élément pour un ID d'évaluation Mainframe Assessment Tool donné. Les spécifications de l'élément incluent son ID, son nom, son utilisation, sa description, son graphique ETL et ses mappages BMS.

Arguments

Nom Type Obligatoire Description
AssessmentId chaîne Oui ID de l'évaluation Mainframe Assessment Tool.
AssetId chaîne Oui ID de l'élément Mainframe Assessment Tool.
DetailedSpec booléen Non (par défaut : false) Si la valeur est définie sur "true", la réponse inclut également les spécifications de la méthode avec leurs cas de test.

FetchAssetsCyclomaticComplexity

Récupère les scores de complexité cyclomatique pour une liste d'éléments pour un ID d'évaluation Mainframe Assessment Tool donné.

Arguments

Nom Type Obligatoire Description
AssessmentId chaîne Oui ID de l'évaluation Mainframe Assessment Tool.
AssetIds chaîne[] Oui Liste des ID d'éléments Mainframe Assessment Tool.

Exemples d'utilisations

Voici des exemples de prompts en langage naturel auxquels un agent d'IA peut répondre en utilisant les outils du serveur MCP pour récupérer et traiter les données d'évaluation :

  • Scénario : rechercher des programmes complexes dans une évaluation.
  • Prompt de l'utilisateur : "Répertoriez les 10 programmes COBOL les plus complexes de l'évaluation nommée AssessmentName."

  • Scénario : rechercher et filtrer les éléments appartenant à un domaine d'activité.
  • Prompt de l'utilisateur : "Répertoriez tous les jobs JCL associés au domaine DomainName dans l'évaluation nommée AssessmentName."

  • Scénario : obtenir les dépendances des éléments à partir d'une évaluation.
  • Prompt de l'utilisateur : "Quelles sont les dépendances du job JCL JCLJobName dans l'évaluation nommée AssessmentName?"