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 do Mainframe Assessment Tool. Por exemplo, você pode fazer o seguinte:

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

Para se preparar para ativar e se conectar ao servidor 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.
  • Configurar 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 do 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

É possível 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 do Mainframe Assessment Tool. Consulte Acessar a VM do Mainframe Assessment Tool 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 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 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 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 respectivos 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, nas especificações geradas por IA e nas regras de negócios em uma avaliação específica do mainframe. Ele oferece suporte aos modos de pesquisa por palavra-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ântica) ou hybrid. O valor padrão é hybrid.

ListBusinessRulesExtractionJobs

Lista os jobs de regras de negócios 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 determinado ID de job de extração de regras de negócios e ID de avaliação da ferramenta 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 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 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?"

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