Ativar o servidor MCP da Mainframe Assessment Tool

Nesta página, descrevemos como configurar e interagir com o servidor MCP da ferramenta de avaliação do mainframe. É possível pesquisar domínios comerciais, recursos e recuperar métricas de complexidade das suas avaliações de mainframe usando comandos de linguagem natural. Para interagir com o servidor MCP, conecte-se por agentes de IA ou clientes do Protocolo de Contexto de Modelo (MCP), como a CLI do Gemini.

Por exemplo, é possível:

  • Listar e conferir as avaliações atuais.
  • Confira 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

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

  • Familiarize-se com a Mainframe Assessment Tool e verifique se você já usou essa ferramenta para fazer uma avaliação.
  • Conceda as permissões necessárias.Para ativar o servidor da ferramenta de avaliação do mainframe (MCP), você precisa de permissões para definir metadados personalizados nas instâncias de VM. Consulte configurar e remover metadados personalizados para mais detalhes sobre os papéis e as 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 ferramenta de avaliação do mainframe, adicione a chave de metadados MAT_ENABLE_MCP e defina o valor dela como true executando o comando gcloud a seguir:

    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 HTTP transmissível.

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.

Exemplos de configuração

As seções a seguir mostram 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 forma:

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

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

SearchContent

Pesquisas no código-fonte, em especificações geradas por IA e em regras de negócios em uma avaliação específica do mainframe. Ele oferece suporte aos modos de pesquisa por palavras-chave (bm25), semântica (embedding) e híbrida (hybrid), permitindo que os usuários localizem recursos e documentação relevantes.

A ferramenta pode filtrar os resultados por tipo de documento (source, spec ou bre), limitar o número de correspondências retornadas e, opcionalmente, recuperar o conteúdo completo dos documentos correspondentes.

Argumentos

Nome Tipo Obrigatório Descrição
AssessmentId string Sim O ID da avaliação da Mainframe Assessment Tool.
Query string Sim A consulta de pesquisa.
DocTypes string[] Não Filtre os resultados por tipo de documento. Os valores aceitos são: source, spec ou bre.
Limit integer Não Limitar o número de correspondências retornadas.
IncludeContent booleano Não Se definido como "true", a resposta também vai incluir o conteúdo completo dos documentos correspondentes. O valor padrão é false.
SearchMode string Não O modo de pesquisa a ser usado. Os valores aceitos são: bm25 (com base em palavras-chave), embedding (semântico) ou hybrid. O valor padrão é hybrid.

ExploreData

Executa um agente de IA interativo (Explorador de dados) que atua como analista de dados para sua avaliação. O agente pode consultar o banco de dados estruturado de uma avaliação específica para responder a perguntas complexas.

Argumentos

Nome Tipo Obrigatório Descrição
AssessmentId string Sim O ID da avaliação da Mainframe Assessment Tool.
Query string Sim A pergunta ou consulta para análise de dados.

ListBusinessRulesExtractionJobs

Lista os jobs de regras comerciais para 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 ID de trabalho de extração de regras de negócios e um ID de avaliação da ferramenta de avaliação do mainframe específicos. Para lidar com o grande número 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 máximo aceito é "25".
PageToken string Não O token da página a ser buscada. Esse valor foi retornado por uma chamada anterior para essa ação.
OrderList objeto Não A ordem em que os resultados são retornados. Consulte as descrições de cada 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 da ordem. Os valores aceitos são: ASCENDING e DESCENDING.
Filter objeto Não Filtre os resultados retornados. Consulte as descrições de cada campo.
Filter.Status string Não O status das regras de negócios para filtrar. 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

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 da tarefa 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."

  • Cenário: analisar dados de avaliação usando linguagem natural.
  • Comando do usuário: "Explique como funciona o fluxo de tratamento de dados do sistema de faturamento na avaliação chamada AssessmentName".