Servidor MCP da Mainframe Assessment Tool

Esta página descreve como configurar e interagir com as avaliações da Mainframe Assessment Tool usando clientes MCP, como a CLI do Gemini ou agentes de IA, pelo Protocolo de Contexto de Modelo (MCP). Você pode usar comandos em linguagem natural para receber insights sobre suas avaliações de mainframe. Com o servidor MCP, é possível usar agentes de IA para realizar operações de descoberta e análise nas avaliações da Mainframe Assessment Tool. Por exemplo, você pode fazer o seguinte:

  • Listar e visualizar as avaliações atuais.
  • Conhecer os domínios de negócios descobertos nas suas avaliações.
  • Pesquisar e filtrar recursos com base em diferentes critérios.
  • Recuperar especificações de recursos, incluindo dependências e métricas de complexidade.

Para mais informações sobre o MCP, consulte O que é o Protocolo de Contexto de Modelo (MCP)?.

Antes de começar

Para se preparar para ativar e se conectar ao servidor MCP, conclua as seguintes tarefas:

  • Familiarize-se com a Mainframe Assessment Tool : verifique se você já usou a Mainframe Assessment Tool para executar uma avaliação.
  • Conceda as permissões necessárias : para ativar o servidor MCP da Mainframe Assessment Tool, você precisa de permissões para definir metadados personalizados nas instâncias de VM. Consulte Definir e remover metadados personalizados para mais detalhes sobre os papéis e permissões necessários.
  • Configure a Google Cloud CLI : instale e configure a versão mais recente da Google Cloud CLI. Para mais informações, consulte Instalar a Google Cloud CLI.

Ativar o servidor MCP

Para ativar o servidor MCP na instância de VM da Mainframe Assessment Tool, adicione a chave de metadados MAT_ENABLE_MCP e defina o valor dela como true executando o seguinte comando gcloud:

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

Substitua:

  • INSTANCE_NAME: o nome da instância de VM.
  • ZONE: a zona em que a instância de VM está localizada.

Se você definir a chave de metadados em uma VM em execução, será necessário reiniciar a VM para que as mudanças entrem em vigor.

Conectar-se ao servidor MCP

Você pode se conectar ao servidor MCP usando agentes de IA padrão que oferecem suporte a conexões MCP por HTTP transmitível.

O servidor MCP está localizado na rota /mcp/ da mesma porta usada para acessar a interface da Mainframe Assessment Tool. Consulte Acessar a VM da Mainframe Assessment Tool pelo computador.

Exemplos de configuração

As seções a seguir fornecem exemplos de como configurar diferentes agentes de IA para se conectar ao servidor MCP.

Substitua LOCAL_PORT: pela porta local usada para acessar a interface da Mainframe Assessment Tool.

CLI do Gemini

Para usar a CLI do Gemini, configure o servidor MCP no arquivo de configurações da CLI do Gemini da seguinte maneira:

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

Para mais informações, consulte Configurar o servidor MCP no settings.json.

Ferramentas do servidor MCP

O servidor MCP da Mainframe Assessment Tool oferece ferramentas que permitem que agentes de IA recuperem dados das suas avaliações.

ListAssessments

Lista todas as avaliações que existem na instância da Mainframe Assessment Tool. Cada avaliação inclui o nome, o ID, a descrição e os carimbos de data/hora.

ListDomains

Lista os domínios de um determinado ID de avaliação da Mainframe Assessment Tool. Cada domínio inclui o nome, a descrição e o ID.

Argumentos

Nome Tipo Obrigatório Descrição
AssessmentId string Sim O ID da avaliação da Mainframe Assessment Tool.

ListAssets

Lista os recursos de um determinado ID de avaliação da Mainframe Assessment Tool. Cada recurso inclui o ID, o nome, o caminho, o tipo e os IDs de domínio atribuídos.

Argumentos

Nome Tipo Obrigatório Descrição
AssessmentId string Sim O ID da avaliação da Mainframe Assessment Tool.

FetchDomain

Busca os detalhes do domínio para um determinado ID de domínio e ID de avaliação da Mainframe Assessment Tool. Os detalhes do domínio incluem ID, nome, descrição e resumo.

Argumentos

Nome Tipo Obrigatório Descrição
AssessmentId string Sim O ID da avaliação da Mainframe Assessment Tool.
DomainId string Sim O ID do domínio da Mainframe Assessment Tool.

FetchAsset

Busca o resumo da especificação de um recurso para um determinado ID de avaliação da Mainframe Assessment Tool. A especificação do recurso inclui o ID, o nome, o uso, a descrição, o gráfico ETL e os mapas BMS.

Argumentos

Nome Tipo Obrigatório Descrição
AssessmentId string Sim O ID da avaliação da Mainframe Assessment Tool.
AssetId string Sim O ID do recurso da Mainframe Assessment Tool.
DetailedSpec booleano Não (padrão: false) Se for definido como verdadeiro, a resposta também incluirá especificações de método com os casos de teste.

FetchAssetsCyclomaticComplexity

Busca as pontuações de complexidade ciclomática de uma lista de recursos para um determinado ID de avaliação da Mainframe Assessment Tool.

Argumentos

Nome Tipo Obrigatório Descrição
AssessmentId string Sim O ID da avaliação da Mainframe Assessment Tool.
AssetIds string[] Sim Lista de IDs de recursos da Mainframe Assessment Tool.

ListBusinessRulesExtractionJobs

Lista os jobs de regras de negócios de um determinado ID de avaliação da Mainframe Assessment Tool. A lista retornada inclui o ID, o nome, o status, o comando de foco e muito mais de cada job.

Argumentos

Nome Tipo Obrigatório Descrição
AssessmentId string Sim O ID da avaliação da Mainframe Assessment Tool.

ListBusinessRules

Lista as regras de negócios extraídas por um determinado ID de job de extração de regras de negócios e ID de avaliação da Mainframe Assessment Tool. Para lidar com uma grande quantidade de regras, essa ação oferece suporte à paginação.

Argumentos

Nome Tipo Obrigatório Descrição
AssessmentId string Sim O ID da avaliação da Mainframe Assessment Tool.
JobId string Sim O ID do job de extração de regras de negócios.
PageSize string Não O tamanho da página a ser buscada. O valor compatível máximo é `25`.
PageToken string Não O token da página a ser buscada. Esse valor foi retornado por uma chamada anterior a essa ação.
OrderList objeto Não A ordem em que os resultados serão retornados. Consulte as descrições por campo.
OrderList.OrderBy string Não O nome do campo em que os resultados serão ordenados. Exemplos: business_rule_id, business_rule_name, status.
OrderList.Order string Não A direção do pedido. Os valores aceitos são: ASCENDING, DESCENDING.
Filter objeto Não Filtra os resultados retornados. Consulte as descrições por campo.
Filter.Status string Não O status das regras de negócios a serem filtradas. Os valores aceitos são: PENDING, VALIDATED, OBSOLETE.
Filter.Tags string[] Não Lista de tags associadas às regras de negócios.
Filter.AssetIDs string[] Não Lista de IDs de recursos da Mainframe Assessment Tool associados às regras de negócios.

Exemplos de uso

A seguir, confira exemplos de comandos em linguagem natural que um agente de IA pode responder usando as ferramentas do servidor MCP para recuperar e processar dados de avaliação:

  • Cenário: encontrar programas complexos em uma avaliação.
  • Comando do usuário: "Liste os 10 programas COBOL mais complexos na avaliação chamada AssessmentName."

  • Cenário: encontrar e filtrar recursos que pertencem a um domínio de negócios.
  • Comando do usuário: "Liste todos os jobs JCL relacionados ao domínio DomainName na avaliação chamada AssessmentName."

  • Cenário: receber dependências de recursos de uma avaliação.
  • Comando do usuário: "Quais são as dependências do job JCL JCLJobName na avaliação chamada AssessmentName?"

  • Cenário: encontrar as regras de negócios extraídas de um determinado job.
  • Comando do usuário: "Liste todas as regras de negócios extraídas por BusinessRuleJobName na avaliação chamada AssessmentName?"