Servidor de MCP de Mainframe Assessment Tool

En esta página, se describe cómo configurar y usar las evaluaciones de Mainframe Assessment Tool con clientes de MCP, como Gemini CLI o agentes de IA, a través del Protocolo de contexto del modelo (MCP). Puedes usar instrucciones en lenguaje natural para obtener estadísticas sobre tus evaluaciones de unidades centrales. Con el servidor de MCP, puedes usar agentes de IA para realizar operaciones de descubrimiento y análisis en tus evaluaciones de Mainframe Assessment Tool. Por ejemplo, puedes hacer lo siguiente:

  • Enumerar y ver las evaluaciones existentes
  • Explorar los dominios empresariales descubiertos en tus evaluaciones
  • Buscar y filtrar recursos según diferentes criterios
  • Recuperar las especificaciones de los recursos, incluidas las dependencias y las métricas de complejidad

Para obtener más información sobre 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 Mainframe Assessment Tool, necesitas permisos para configurar metadatos personalizados en tus instancias de VM. Consulta Cómo configurar y quitar 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 tu 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: por la zona en la que se encuentra tu instancia de VM.

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

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 de acceso /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 conectarse 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 Mainframe Assessment Tool proporciona herramientas que permiten a los agentes de IA recuperar datos de tus evaluaciones.

ListAssessments

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

ListDomains

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

Argumentos

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

ListAssets

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

Argumentos

Nombre Tipo Obligatorio Descripción
AssessmentId string 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 string Sí Es el ID de la evaluación de Mainframe Assessment Tool.
DomainId string Sí Es el ID del dominio de Mainframe Assessment Tool.

FetchAsset

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

Argumentos

Nombre Tipo Obligatorio Descripción
AssessmentId string Sí Es el ID de la evaluación de Mainframe Assessment Tool.
AssetId string Sí Es el ID del recurso de Mainframe Assessment Tool.
DetailedSpec booleano No (predeterminado: false) Si se establece en true, 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 recursos para un ID de evaluación de Mainframe Assessment Tool determinado.

Argumentos

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

ListBusinessRulesExtractionJobs

Muestra los trabajos de reglas de negocio para un ID de evaluación de Mainframe Assessment Tool determinado. La lista que se muestra 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 string Sí Es el ID de la evaluación de Mainframe Assessment Tool.

ListBusinessRules

Muestra las reglas de negocio que se extrajeron con un ID de trabajo de extracción de reglas de negocio y un ID de evaluación de Mainframe Assessment Tool determinados. Para manejar una gran cantidad de reglas, esta acción admite la paginación.

Argumentos

Nombre Tipo Obligatorio Descripción
AssessmentId string Sí Es el ID de la evaluación de Mainframe Assessment Tool.
JobId string Sí Es el ID del trabajo de extracción de reglas de negocio.
PageSize string No Es el tamaño de la página que se recuperará. El valor máximo admitido es `25`.
PageToken string No Es el token de la página que se recuperará. Este valor se mostró en una llamada anterior a esta acción.
OrderList objeto No Es el orden en el que se mostrarán los resultados. Consulta las descripciones por campo.
OrderList.OrderBy string No Es el nombre del campo según el cual se ordenarán los resultados. Por ejemplo: business_rule_id, business_rule_name, status.
OrderList.Order string 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 por campo.
Filter.Status string 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 una lista de etiquetas asociadas con las reglas de negocio.
Filter.AssetIDs string[] No Es una lista de IDs de recursos de Mainframe Assessment Tool asociados con las reglas de negocio.

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: Busca programas complejos en una evaluación.
  • Instrucción del usuario: "List the 10 most complex COBOL programs in the assessment called AssessmentName."

  • Situación: Busca y filtra recursos que pertenecen a un dominio empresarial.
  • Instrucción del usuario: "List all the JCL jobs related to the DomainName domain under the assessment called AssessmentName."

  • Situación: Obtén dependencias de recursos de una evaluación.
  • Instrucción del usuario: "What are the dependencies of the JCL job JCLJobName in the assessment called AssessmentName?"

  • Situación: Busca las reglas de negocio extraídas de un trabajo determinado.
  • Instrucción del usuario: "List all business rules extracted by BusinessRuleJobName in the assessment called AssessmentName?"