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 comerciais 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

Confira se você conhece a Mainframe Assessment Tool e já a usou para fazer uma avaliação.

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.

IDE do Antigravity

Para usar o IDE do Antigravity, configure o servidor MCP personalizado em mcp_config.json da seguinte maneira:

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

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.

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 comercial.
  • 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?"