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 mainframe. 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:

  • 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

Asegúrate de conocer Mainframe Assessment Tool y de haberla usado para ejecutar una evaluación.

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 admiten conexiones de MCP a través de SSE (eventos enviados por el servidor).

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.

Por ejemplo, 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": {
      "url": "http://localhost:LOCAL_PORT/mcp/"
    }
  }
}

Reemplaza lo siguiente:

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

Para obtener más información, consulta Configura 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 que existen 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 la herramienta de evaluación de Mainframe 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 recursos de un ID de evaluación determinado de la herramienta Mainframe Assessment Tool.

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.

Ejemplos de uso

A continuación, se muestran ejemplos de instrucciones en lenguaje natural que un agente de IA puede responder usando 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: "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?"