Autopilot MCP

工具

DWS Autopilot MCP Server 提供以下工具：

1. dws_autopilot_get_clusters 查询 DWS 集群列表，无需参数。
2. dws_autopilot_get_hosts 查询 DWS 集群节点信息，支持过滤、分页、排序。
   • 必填：cluster_id（字符串）— 集群 ID
   • 可选过滤：filter（host_name / work_ip）、value、sub_filter、sub_value
   • 可选分页：page_size（默认 10，最大 2000）、page_num（默认 1）、offset（默认 0）、limit（默认 512）
   • 可选排序：order_by（cpu_usage、mem_usage、disk_usage_avg、disk_io、tcp_resend_rate、net_io）、sort_by（ASC / DESC，默认 DESC）
3. dws_autopilot_get_metric 查询 DWS 集群指标时序数据。
   • 必填：cluster_id（字符串）、metric_name（字符串）、from_ts（13 位 Unix 时间戳，毫秒）、to_ts（13 位 Unix 时间戳，毫秒）
   • 支持的指标：cpu_usage、mem_usage、disk_usage_avg、tcp_resend_rate、disk_io、net_io、cpu_io_diagnose_detail（返回包含 query_id 和 query 字段的逐查询详情）
   • 可选：offset（默认 0）、limit（最大 1000，默认 50）、order_by、sort_by（ASC / DESC）

认证方式

采用 AK/SK 签名认证：

• AK/SK 签名模式：使用华为云 Access Key（AK）和 Secret Key（SK）对每个 API 请求进行签名，签名后自动添加 Authorization 和 X-Sdk-Date 请求头完成认证。
• 如果配置了 project_id，会自动添加 X-Project-Id 请求头，用于多项目场景。

配置加密

敏感字段（AK、SK）支持 AES-256-GCM 加密存储：

• 启动 MCP Server 时自动检测明文并加密
• 基于机器指纹的密钥保护，绑定当前机器环境
• 主密钥双重保护：crypter（存储在 yaml）+ cryptComponent（存储在 crypt.json）

环境准备

• Python 3.10 及以上
• pip 包管理器

安装

# 克隆源码
git clone <repo_url>
cd dws_autopilot_mcp

# 安装依赖
pip install .

配置说明

配置文件位于 conf/dws_config.yaml，首次使用需填写配置：

region_id: "cn-north-7"
ak: "your_access_key"
sk: "your_secret_key"
project_id: "your_project_id"
http_proxy: "http://proxy.example.com:8080"
https_proxy: "http://proxy.example.com:8080"
proxy_username: "your_proxy_user"
proxy_password: "your_proxy_password"

region_id 会自动生成 DMS_MONITORING_BASE_URL（https://dws.{region_id}.myhuaweicloud.com），无需手动配置。

配置管理 CLI

安装后提供 dws-mcp-config 命令行工具，需在项目根目录（dws_autopilot_mcp/）下执行：

init - 初始化/更新配置

init 命令用于设置配置参数：

python -m dws_autopilot_mcp.config_cli init --region_id cn-north-7 --ak your_ak --sk your_sk --project_id your_project_id

init 命令支持部分更新，仅更新指定的参数，未指定的参数保持不变。例如只更新 AK：python -m dws_autopilot_mcp.config_cli init --ak new_ak。

更新配置后，重启 MCP Server 即可自动加密敏感字段（AK、SK）。

其他命令

# 手动触发加密（将明文敏感字段加密，启动 MCP Server 时也会自动执行）
python -m dws_autopilot_mcp.config_cli encrypt

# 查看配置状态（敏感信息以 ****** 显示，不会泄露）
python -m dws_autopilot_mcp.config_cli show

# 重置配置为空模板（清空所有参数，删除 crypt.json）
python -m dws_autopilot_mcp.config_cli reset

encrypt、show、reset 命令无需额外参数。

客户端配置

以 OpenCode 为例，在 MCP Servers 配置中添加：

{
  "dws_autopilot_mcp": {
    "type": "local",
    "command": [
      "/path/to/python.exe",
      "-m",
      "dws_autopilot_mcp.server"
    ],
    "environment": {
      "PYTHONPATH": "/path/to/dws_autopilot_mcp/src"
    }
  }
}

将 /path/to/python.exe 替换为本机 Python 可执行文件路径，/path/to/dws_autopilot_mcp/src 替换为本项目 src 目录的绝对路径。Windows 下 PYTHONPATH 使用 ; 分隔，Linux/macOS 使用 : 分隔。

也可通过环境变量 DWS_MCP_CONFIG 指定配置文件路径。