Servidor MCP da Mainframe Assessment Tool

Nesta página, descrevemos como configurar e interagir com as avaliações da Mainframe Assessment Tool usando clientes do 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 Ferramenta de avaliação de mainframe. Por exemplo, você pode fazer o seguinte:

  • Listar e conferir avaliações atuais.
  • Confira os domínios comerciais descobertos nas suas avaliações.
  • Pesquisar e filtrar recursos com base em diferentes critérios.
  • Recupere 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 ferramenta de avaliação do mainframe, 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

É possível se conectar ao servidor MCP usando agentes de IA padrão que oferecem suporte a conexões MCP por SSE (eventos enviados pelo servidor).

O servidor MCP está localizado na rota /mcp/ da mesma porta usada para acessar a interface da ferramenta de avaliação do mainframe. Consulte Acessar a VM da ferramenta de avaliação do mainframe no seu computador.

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

Substitua:

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

Para mais informações, consulte Configurar o servidor MCP em 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 nome, ID, descrição e 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 ID, nome, caminho, tipo e 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 de um domínio para um determinado ID de domínio e ID de avaliação da ferramenta de avaliação de mainframe. 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 ID, nome, uso, descrição, gráfico de ETL e mapas do 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 "true", a resposta também vai 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 ferramenta de avaliação do mainframe.

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

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"

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

  • Cenário: extrair 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?"