Mainframe Assessment Tool MCP 服务器

本页面介绍了如何通过 Model Context Protocol (MCP) 使用 Gemini CLI 或 AI 智能体等 MCP 客户端设置 Mainframe Assessment Tool 评估并与之互动。您可以使用自然语言提示来深入了解大型机评估结果。借助 MCP 服务器，您可以使用 AI 代理对大型主机评估工具评估执行发现和分析操作。例如，您可以执行以下操作：

  • 列出并查看现有评估。
  • 探索在评估中发现的业务网域。
  • 根据不同条件搜索和过滤资产。
  • 检索资源规范，包括依赖项和复杂性指标。

如需详细了解 MCP，请参阅 什么是 Model Context Protocol (MCP)？。

准备工作

确保您熟悉 Mainframe Assessment Tool，并且已使用它运行评估。

启用 MCP 服务器

如需在 Mainframe Assessment Tool 虚拟机实例上启用 MCP 服务器，请运行以下 gcloud 命令，添加 MAT_ENABLE_MCP 元数据键并将其值设置为 true：

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

替换以下内容：

  • INSTANCE_NAME：虚拟机实例的名称。
  • ZONE：虚拟机实例所在的可用区。

如果您在正在运行的虚拟机上设置元数据键，则必须重启该虚拟机才能使更改生效。

连接到 MCP 服务器

您可以使用支持通过 SSE（服务器发送的事件）进行 MCP 连接的标准 AI 代理连接到 MCP 服务器。

MCP 服务器位于用于访问 Mainframe Assessment Tool 界面的同一端口的 /mcp/ 路由下，请参阅从计算机访问 Mainframe Assessment Tool 虚拟机。

例如，如需使用 Gemini CLI，请在 Gemini CLI 设置文件中按如下方式配置 MCP 服务器：

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

替换以下内容：

  • LOCAL_PORT：用于访问 Mainframe Assessment Tool 界面的本地端口。

如需了解详情，请参阅在 settings.json 中配置 MCP 服务器。

MCP 服务器工具

Mainframe Assessment Tool MCP 服务器提供的工具可让 AI 智能体从评估中检索数据。

ListAssessments

列出 Mainframe Assessment Tool 实例中的所有评估。每次评估都包含其名称、ID、说明和时间戳。

ListDomains

列出指定 Mainframe Assessment Tool 评估 ID 的网域。每个网域都包含其名称、说明和 ID。

参数

名称 类型 必需 说明
AssessmentId 字符串 是 Mainframe Assessment Tool 评估的 ID。

ListAssets

列出指定 Mainframe Assessment Tool 评估 ID 的资产。每项资源都包含其 ID、名称、路径、类型和分配的网域 ID。

参数

名称 类型 必需 说明
AssessmentId 字符串 是 Mainframe Assessment Tool 评估的 ID。

FetchDomain

获取指定网域 ID 和大型主机评估工具评估 ID 的网域详细信息。网域详细信息包括 ID、名称、说明和摘要。

参数

名称 类型 必需 说明
AssessmentId 字符串 是 Mainframe Assessment Tool 评估的 ID。
DomainId 字符串 是 Mainframe Assessment Tool 网域的 ID。

FetchAsset

针对给定的 Mainframe Assessment Tool 评估 ID，提取相应资产的规范摘要。资源规范包括其 ID、名称、用途、说明、ETL 图和 BMS 映射。

参数

名称 类型 必需 说明
AssessmentId 字符串 是 Mainframe Assessment Tool 评估的 ID。
AssetId 字符串 是 Mainframe Assessment Tool 资产的 ID。
DetailedSpec 布尔值 否（默认值：false） 如果设置为 true，响应还会包含方法规范及其测试用例。

FetchAssetsCyclomaticComplexity

针对指定 Mainframe Assessment Tool 评估 ID 的一组资产，获取其圈复杂度得分。

参数

名称 类型 必需 说明
AssessmentId 字符串 是 Mainframe Assessment Tool 评估的 ID。
AssetIds 字符串[] 是 Mainframe Assessment Tool 资产 ID 的列表。

使用示例

以下是一些自然语言提示示例，AI 智能体可以使用 MCP 服务器工具检索和处理评估数据来回答这些提示：

  • 场景：在评估中查找复杂程序。
  • 用户提示：“列出评估 AssessmentName 中最复杂的 10 个 COBOL 程序。”

  • 场景：查找和过滤属于某个企业网域的资产。
  • 用户提示：“列出评估 AssessmentName 下与 DomainName 领域相关的所有 JCL 作业。”

  • 场景：从评估中获取资产依赖项。
  • 用户提示：“评估 AssessmentName 中 JCL 作业 JCLJobName 的依赖项是什么？”