Habilita el servidor de MCP de la Mainframe Assessment Tool

En esta página, se describe cómo configurar el servidor de MCP de la herramienta de evaluación de Mainframe y cómo interactuar con él. Puedes explorar dominios comerciales, buscar recursos y recuperar métricas de complejidad de tus evaluaciones de mainframe con instrucciones en lenguaje natural. Para interactuar con el servidor de MCP, conéctate a través de agentes de IA o clientes del Protocolo de contexto del modelo (MCP), como Gemini CLI.

Por ejemplo, puedes hacer lo siguiente:

  • Enumera y visualiza las evaluaciones existentes.
  • Explora los dominios comerciales descubiertos en tus evaluaciones.
  • Buscar y filtrar activos según diferentes criterios
  • Recupera las especificaciones de los recursos, incluidas las dependencias y las métricas de complejidad.

Para obtener más información sobre el MCP, consulta ¿Qué es el Protocolo de contexto del modelo (MCP)?.

Antes de comenzar

Para prepararte para habilitar el servidor de MCP y conectarte a él, completa las siguientes tareas:

  • Familiarízate con Mainframe Assessment Tool. Asegúrate de haber usado Mainframe Assessment Tool para ejecutar una evaluación.
  • Otorga los permisos necesarios. Para habilitar el servidor de MCP de la herramienta de evaluación de Mainframe, necesitas permisos para establecer metadatos personalizados en tus instancias de VM. Consulta Configura y quita metadatos personalizados para obtener detalles sobre los roles y permisos necesarios.
  • Configura Google Cloud CLI. Instala y configura la versión más reciente de Google Cloud CLI. Para obtener más información, consulta Instala Google Cloud CLI.

Habilita el servidor de MCP

Para habilitar el servidor de MCP en la instancia de VM de Mainframe Assessment Tool, agrega la clave de metadatos MAT_ENABLE_MCP y configura su valor en true ejecutando el siguiente comando gcloud:

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

Reemplaza lo siguiente:

  • INSTANCE_NAME por el nombre de tu instancia de VM.
  • ZONE: La zona en la que se encuentra la instancia de VM.

Si configuras la clave de metadatos en una VM en ejecución, debes reiniciar la VM para que se apliquen los cambios.

Conéctate al servidor de MCP

Puedes conectarte al servidor de MCP con agentes de IA estándar que admitan conexiones de MCP a través de HTTP transmitible.

El servidor de MCP se encuentra en la ruta /mcp/ del mismo puerto que se usa para acceder a la IU de Mainframe Assessment Tool. Consulta Cómo acceder a la VM de Mainframe Assessment Tool desde tu computadora.

Ejemplos de configuración

En las siguientes secciones, se proporcionan ejemplos de cómo configurar diferentes agentes de IA para que se conecten al servidor de MCP.

Reemplaza LOCAL_PORT: por el puerto local que se usa para acceder a la IU de Mainframe Assessment Tool.

Gemini CLI

Para usar Gemini CLI, configura el servidor de MCP en el archivo de configuración de Gemini CLI de la siguiente manera:

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

Para obtener más información, consulta Cómo configurar el servidor de MCP en settings.json.

Herramientas del servidor de MCP

El servidor de MCP de la Mainframe Assessment Tool proporciona herramientas que permiten a los agentes de IA recuperar datos de tus evaluaciones.

ListAssessments

Enumera todas las evaluaciones en la instancia de Mainframe Assessment Tool. Cada evaluación incluye su nombre, ID, descripción y marcas de tiempo.

ListDomains

Enumera los dominios para un ID de evaluación determinado de Mainframe Assessment Tool. Cada dominio incluye su nombre, descripción y ID.

Argumentos

Nombre Tipo Obligatorio Descripción
AssessmentId cadena Sí Es el ID de la evaluación de Mainframe Assessment Tool.

ListAssets

Enumera los activos para un ID de evaluación determinado de la Mainframe Assessment Tool. Cada recurso incluye su ID, nombre, ruta de acceso, tipo y los IDs de dominio asignados.

Argumentos

Nombre Tipo Obligatorio Descripción
AssessmentId cadena Sí Es el ID de la evaluación de Mainframe Assessment Tool.

FetchDomain

Recupera los detalles del dominio para un ID de dominio y un ID de evaluación de Mainframe Assessment Tool determinados. Los detalles del dominio incluyen el ID, el nombre, la descripción y el resumen.

Argumentos

Nombre Tipo Obligatorio Descripción
AssessmentId cadena Sí Es el ID de la evaluación de Mainframe Assessment Tool.
DomainId cadena Sí Es el ID del dominio de Mainframe Assessment Tool.

FetchAsset

Recupera el resumen de especificaciones de un activo para un ID de evaluación determinado de Mainframe Assessment Tool. La especificación del recurso incluye su ID, nombre, uso, descripción, gráfico de ETL y mapas del BMS.

Argumentos

Nombre Tipo Obligatorio Descripción
AssessmentId cadena Sí Es el ID de la evaluación de Mainframe Assessment Tool.
AssetId cadena Sí Es el ID del activo de Mainframe Assessment Tool.
DetailedSpec booleano No (predeterminado: false) Si se establece como verdadero, la respuesta también incluye especificaciones de métodos con sus casos de prueba.

FetchAssetsCyclomaticComplexity

Recupera las puntuaciones de complejidad ciclomática para una lista de activos de un ID de evaluación determinado de la herramienta de evaluación de Mainframe.

Argumentos

Nombre Tipo Obligatorio Descripción
AssessmentId cadena Sí Es el ID de la evaluación de Mainframe Assessment Tool.
AssetIds string[] Sí Es la lista de IDs de los recursos de Mainframe Assessment Tool.

SearchContent

Realiza búsquedas en el código fuente, las especificaciones generadas por IA y las reglas de negocio dentro de una evaluación específica de mainframe. Admite modos de búsqueda basados en palabras clave (bm25), semánticos (embedding) e híbridos (hybrid), lo que permite a los usuarios encontrar recursos y documentación relevantes.

La herramienta puede filtrar los resultados por tipo de documento (source, spec o bre), limitar la cantidad de coincidencias que se muestran y, de manera opcional, recuperar el contenido completo de los documentos coincidentes.

Argumentos

Nombre Tipo Obligatorio Descripción
AssessmentId cadena Sí Es el ID de la evaluación de Mainframe Assessment Tool.
Query cadena Sí Es la búsqueda.
DocTypes string[] No Filtrar los resultados por tipo de documento Los valores admitidos son source, spec o bre.
Limit integer No Limita la cantidad de coincidencias devueltas.
IncludeContent booleano No Si se establece como verdadero, la respuesta también incluye el contenido completo de los documentos coincidentes. El valor predeterminado es false.
SearchMode cadena No Es el modo de búsqueda que se usará. Los valores admitidos son bm25 (basado en palabras clave), embedding (semántico) o hybrid. El valor predeterminado es hybrid.

ExploreData

Ejecuta un agente de IA interactivo (Explorador de datos) que actúa como analista de datos para tu evaluación. El agente puede consultar la base de datos estructurada subyacente de una evaluación específica para responder preguntas complejas.

Argumentos

Nombre Tipo Obligatorio Descripción
AssessmentId cadena Sí Es el ID de la evaluación de Mainframe Assessment Tool.
Query cadena Sí Pregunta o consulta para la exploración de datos.

ListBusinessRulesExtractionJobs

Enumera los trabajos de reglas de negocio para un ID de evaluación determinado de la Mainframe Assessment Tool. La lista que se devuelve incluye el ID, el nombre, el estado, la instrucción de enfoque y mucho más de cada trabajo.

Argumentos

Nombre Tipo Obligatorio Descripción
AssessmentId cadena Sí Es el ID de la evaluación de Mainframe Assessment Tool.

ListBusinessRules

Enumera las reglas de negocio extraídas por un ID de trabajo de extracción de reglas de negocio específico y un ID de evaluación de la herramienta de evaluación de Mainframe. Para controlar la gran cantidad de reglas, esta acción admite la paginación.

Argumentos

Nombre Tipo Obligatorio Descripción
AssessmentId cadena Sí Es el ID de la evaluación de Mainframe Assessment Tool.
JobId cadena Sí Es el ID del trabajo de extracción de reglas de negocio.
PageSize cadena No Es el tamaño de la página que se recuperará. El valor máximo admitido es "25".
PageToken cadena No Es el token de la página que se recuperará. Este valor se devolvió en una llamada anterior a esta acción.
OrderList objeto No Es el orden en el que se devuelven los resultados. Consulta las descripciones de cada campo.
OrderList.OrderBy cadena No Nombre del campo según el cual se ordenarán los resultados. Ejemplos: business_rule_id, business_rule_name, status.
OrderList.Order cadena No Es la dirección del orden. Los valores admitidos son ASCENDING y DESCENDING.
Filter objeto No Filtra los resultados que se muestran. Consulta las descripciones de cada campo.
Filter.Status cadena No Es el estado de las reglas de negocio por el que se filtrará. Los valores admitidos son PENDING, VALIDATED y OBSOLETE.
Filter.Tags string[] No Es la lista de etiquetas asociadas con las reglas de negocio.
Filter.AssetIDs string[] No Es una lista de los IDs de activos de la herramienta Mainframe Assessment Tool asociados con las reglas de negocios.

Ejemplos de uso

A continuación, se muestran ejemplos de instrucciones en lenguaje natural que un agente de IA puede responder con las herramientas del servidor de MCP para recuperar y procesar datos de evaluación:

  • Situación: Encuentra programas complejos en una evaluación.
  • Instrucción del usuario: "Enumera los 10 programas COBOL más complejos de la evaluación llamada AssessmentName".

  • Situación: Busca y filtra los recursos que pertenecen a un dominio comercial.
  • Instrucción del usuario: "Enumera todos los trabajos de JCL relacionados con el dominio DomainName en la evaluación llamada AssessmentName".

  • Situación: Obtén las dependencias de recursos de una evaluación.
  • Instrucción del usuario: "¿Cuáles son las dependencias del trabajo de JCL JCLJobName en la evaluación llamada AssessmentName?"

  • Situación: Encuentra las reglas de negocio extraídas de un trabajo determinado.
  • Instrucción del usuario: "Enumera todas las reglas de negocio que extrajo BusinessRuleJobName en la evaluación llamada AssessmentName".

  • Situación: Explora los datos de evaluación con lenguaje natural.
  • Instrucción del usuario: "Explica cómo funciona el flujo de procesamiento de datos para el sistema de facturación en la evaluación llamada AssessmentName".