Activer le serveur MCP Mainframe Assessment Tool

Cette page explique comment configurer le serveur MCP de Mainframe Assessment Tool et interagir avec lui. Vous pouvez explorer des domaines d'activité, rechercher des assets et récupérer des métriques de complexité à partir de vos évaluations de mainframe à l'aide de requêtes en langage naturel. Pour interagir avec le serveur MCP, connectez-vous via des agents IA ou des clients MCP (Model Context Protocol), tels que Gemini CLI.

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 assets selon différents critères.
  • Récupérer les spécifications des assets, y compris les dépendances et les métriques de complexité.

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

Avant de commencer

Pour vous préparer à activer le serveur MCP et à vous y connecter, effectuez les tâches suivantes :

  • Familiarisez-vous avec Mainframe Assessment Tool. Assurez-vous d'avoir déjà utilisé Mainframe Assessment Tool pour exécuter une évaluation.
  • Accordez les autorisations nécessaires. Pour activer le serveur MCP de Mainframe Assessment Tool, vous devez disposer des autorisations nécessaires pour définir des métadonnées personnalisées sur vos instances de VM. Pour en savoir plus sur les rôles et autorisations requis, consultez Définir et supprimer des métadonnées personnalisées.
  • Configurez Google Cloud CLI. Installez et configurez la dernière version de Google Cloud CLI. Pour en savoir plus, consultez Installer Google Cloud CLI.

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 dans laquelle 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 la redémarrer pour que les modifications prennent effet.

Se connecter au serveur MCP

Vous pouvez vous connecter au serveur MCP à l'aide d'agents 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 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.

Outils du serveur MCP

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

ListAssessments

Répertorie toutes les évaluations 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 assets pour un ID d'évaluation Mainframe Assessment Tool donné. Chaque asset 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 asset pour un ID d'évaluation Mainframe Assessment Tool donné. Les spécifications de l'asset 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'asset 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'assets 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'assets Mainframe Assessment Tool.

SearchContent

Effectue une recherche dans le code source, les spécifications générées par l'IA et les règles métier au sein d'une évaluation de mainframe spécifique. Il est compatible avec les modes de recherche basés sur des mots clés (bm25), sémantiques (embedding) et hybrides (hybrid), ce qui permet aux utilisateurs de localiser les assets et la documentation pertinents.

L'outil peut filtrer les résultats par type de document (source, spec ou bre), limiter le nombre de correspondances renvoyées et, éventuellement, récupérer l'intégralité du contenu des documents correspondants.

Arguments

Nom Type Obligatoire Description
AssessmentId chaîne Oui ID de l'évaluation Mainframe Assessment Tool.
Query chaîne Oui Requête de recherche.
DocTypes chaîne[] Non Filtrer les résultats par type de document. Les valeurs compatibles sont source, spec ou bre.
Limit entier Non Limiter le nombre de correspondances renvoyées.
IncludeContent booléen Non Si la valeur est définie sur "true", la réponse inclut également l'intégralité du contenu des documents correspondants. La valeur par défaut est false.
SearchMode chaîne Non Mode de recherche à utiliser. Les valeurs compatibles sont bm25 (basé sur des mots clés), embedding (sémantique) ou hybrid. La valeur par défaut est hybrid.

ExploreData

Exécute un agent IA interactif (Explorateur de données) qui agit comme un analyste de données pour votre évaluation. L'agent peut interroger la base de données structurée sous-jacente d'une évaluation spécifique pour répondre à des questions complexes.

Arguments

Nom Type Obligatoire Description
AssessmentId chaîne Oui ID de l'évaluation Mainframe Assessment Tool.
Query chaîne Oui Question ou requête pour l'exploration des données.

ListBusinessRulesExtractionJobs

Répertorie les jobs de règles métier pour un ID d'évaluation Mainframe Assessment Tool donné. La liste renvoyée inclut l'ID, le nom, l'état, l'invite de focus et plus encore pour chaque job.

Arguments

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

ListBusinessRules

Répertorie les règles métier extraites par un ID de job d'extraction de règles métier et un ID d'évaluation Mainframe Assessment Tool spécifiques. Pour gérer le grand nombre de règles, cette action est compatible avec la pagination.

Arguments

Nom Type Obligatoire Description
AssessmentId chaîne Oui ID de l'évaluation Mainframe Assessment Tool.
JobId chaîne Oui ID du job d'extraction de règles métier.
PageSize chaîne Non Taille de la page à récupérer. La valeur maximale acceptée est `25`.
PageToken chaîne Non Jetons de la page à récupérer. Cette valeur a été renvoyée par un appel précédent à cette action.
OrderList objet Non Ordre dans lequel renvoyer les résultats. Consultez les descriptions par champ.
OrderList.OrderBy chaîne Non Nom du champ sur lequel baser l'ordre des résultats. Exemples : business_rule_id, business_rule_name, status.
OrderList.Order chaîne Non Sens de l'ordre. Les valeurs compatibles sont ASCENDING et DESCENDING.
Filter objet Non Filtrer les résultats renvoyés. Consultez les descriptions par champ.
Filter.Status chaîne Non État des règles métier à filtrer. Les valeurs compatibles sont PENDING, VALIDATED et OBSOLETE.
Filter.Tags chaîne[] Non Liste des tags associés aux règles métier.
Filter.AssetIDs chaîne[] Non Liste des ID d'assets Mainframe Assessment Tool associés aux règles métier.

Exemples d'utilisations

Voici des exemples de requêtes en langage naturel auxquelles un agent IA peut répondre à l'aide des outils du serveur MCP pour récupérer et traiter les données d'évaluation :

  • Scénario : rechercher des programmes complexes dans une évaluation.
  • Requête utilisateur : "List the 10 most complex COBOL programs in the assessment called AssessmentName."

  • Scénario : rechercher et filtrer les assets appartenant à un domaine d'activité.
  • Requête utilisateur : "List all the JCL jobs related to the DomainName domain under the assessment called AssessmentName."

  • Scénario : obtenir les dépendances des assets à partir d'une évaluation.
  • Requête utilisateur : "What are the dependencies of the JCL job JCLJobName in the assessment called AssessmentName?"

  • Scénario : rechercher les règles métier extraites à partir d'un job donné.
  • Requête utilisateur : "List all business rules extracted by BusinessRuleJobName in the assessment called AssessmentName."

  • Scénario : explorer les données d'évaluation à l'aide du langage naturel.
  • Requête utilisateur : "Explain how the data processing flow works for the billing system in the assessment called AssessmentName."