MCP 工具目录

认证与系统

4

工具名称	描述
authenticate	登录认证，使用 API 密钥连接 OpsDash
whoami	查看当前身份、角色、权限列表及 MCP Server 运行统计
confirm_action写	执行待确认的写操作（两步审批的第二步）
list_pending_confirmations	查看所有未过期的挂起操作列表

仪表盘与概览

11

工具名称	描述
get_dashboard_overview	全局概览：设备统计、客户列表、实时告警
get_ops_briefing	运维简报：系统概览 + 未解决告警 + 7 天趋势 + CPU Top 5 + SLA
get_customer_overview	客户运维全景：客户信息 + 设备列表 + 未解决告警
get_system_health	监控引擎健康：Zabbix / EMQX / VictoriaMetrics 连通状态
get_sla_overview	SLA 效能概览：MTTA / MTTR / 达成率
update_sla_targets写	更新 SLA 目标（MTTA / MTTR 分钟数，支持全局 / 部门 / 级别）
get_resource_topn	资源利用率 Top N（CPU / 内存 / 磁盘）
get_resource_trend	全局资源趋势（指定指标的平均利用率变化）
get_health_heatmap	设备健康热力图（按部门 / 类型 / 位置分组）
get_ops_calendar	运维事件日历：维护窗口、重大告警、变更事件
get_mcp_stats	MCP Server 运行统计：启动时间、工具数、活跃会话数

设备管理

17

工具名称	描述
search_devices	搜索设备（模糊匹配名称 / IP / 主机名 / MAC / 序列号）
get_device_detail	设备详情：关联客户、已安装软件、链路关系
diagnose_device	设备健康诊断：设备信息 + 指标 + 未解决告警
create_device写	创建设备（自动同步到 Zabbix）
update_device写	修改设备信息
delete_device写	删除设备（级联删除关联软件和链路）
batch_tag_devices写	批量打标签
assign_device_proxy写	指定设备监控代理（Proxy）
get_device_sla	查询设备 SLA 指标
get_device_location	获取设备 GPS 位置
export_devices	导出设备列表（CSV / Excel）
import_devices_preview	导入预览：校验 + 去重 + 冲突检测
import_devices_confirm写	确认导入设备
execute_ssh_command写	SSH 远程命令执行（单台设备）
search_all	全局搜索：同时搜索设备、软件、部门、告警
device_batch_action写	统一设备批量操作（推荐入口，delete/update 二合一）
device_lifecycle_action写	统一设备生命周期操作（推荐入口，decommission/restore 二合一）

软件资产

7

工具名称	描述
list_software	查询软件列表（按设备 / 类型 / 状态 / 客户筛选）
create_software写	添加软件记录
update_software写	修改软件信息
delete_software写	删除软件记录
list_software_dependencies	查看软件依赖关系（依赖了谁 + 被谁依赖）
add_software_dependency写	添加软件依赖关系
remove_software_dependency写	删除软件依赖关系

告警处理

14

工具名称	描述
list_alerts	查询实时告警（按级别 / 来源 / 已解决状态筛选）
get_alert_detail	告警详情：完整字段含级别、消息、触发时间、来源
get_alert_trend	告警趋势：按天按级别统计（1-30 天）
get_alert_trend_detail	告警趋势明细数据
diagnose_alert	告警诊断报告：告警 + 设备 + 指标 + 关联告警
batch_diagnose_alerts	批量告警诊断
get_root_cause_hint	获取告警根因分析提示
list_alert_correlation_groups	列出告警关联组（同一级联故障归为一组）
get_correlation_group_detail	关联组详情：组内告警 + 根因分析
batch_resolve_correlation_group写	批量解决关联组内所有告警
list_alert_exclusions	列出维护窗口排除规则
create_alert_exclusion写	创建维护窗口（时间段内告警自动标记排除）
delete_alert_exclusion写	删除维护窗口
alert_action写	统一告警写操作（推荐入口，单条/批量 × 确认/解决四合一）

告警规则

5

工具名称	描述
list_alert_rules	查询告警规则列表
create_alert_rule写	创建告警规则（指标名 + 阈值 + 持续时间）
create_alert_rule_from_template写	从模板创建告警规则
toggle_alert_rule写	启用 / 禁用告警规则
delete_alert_rule写	删除告警规则

客户 / 部门管理

5

工具名称	描述
list_customers	查询客户 / 部门列表
get_customer_detail	客户详情：关联设备和软件统计
create_customer写	创建客户 / 部门
update_customer写	修改客户信息
delete_customer写	删除客户（级联删除关联设备和软件）

扫描发现

10

工具名称	描述
list_scan_tasks	查看扫描任务列表
create_scan_task写	创建扫描任务（子网列表 + 可选自动纳管）
run_scan_task写	启动扫描任务
get_scan_task_status	查看扫描进度
cancel_scan_task写	取消运行中的扫描任务
list_discovered_devices	发现设备列表（按状态 / 任务 ID 筛选）
approve_discovered_device写	纳管发现的设备
batch_approve_devices写	批量纳管发现的设备
reject_discovered_device写	拒绝发现的设备
probe_ip	探测单个 IP（SNMP / 端口 / OS 识别）

监控查询

3

工具名称	描述
query_metrics	PromQL 监控查询（瞬时 / 范围查询）
list_metric_names	列出可用监控指标名称
list_templates	统一模板查询（OpsDash + Zabbix 合并）

拓扑与链路

5

工具名称	描述
get_topology	获取拓扑图数据（节点 + 连线）
list_device_links	查询设备链路关系
create_device_link写	创建设备链路（主链路 / 备份链路）
delete_device_link写	删除设备链路
analyze_impact	故障影响分析（BFS 拓扑分析下游设备和软件服务）

通知与升级策略

7

工具名称	描述
list_notification_configs	查询告警通知配置列表（邮件 / 钉钉 / 飞书 / 企微）
create_notification_config写	创建告警通知配置
update_notification_config写	更新通知配置
delete_notification_config写	删除告警通知配置
test_notification写	测试通知发送
list_escalation_policies	列出升级策略
create_escalation_policy写	创建升级策略

远程运维

25

工具名称	描述
list_remote_jobs	查询远程任务列表（按状态 / 类型筛选）
get_remote_job_detail	远程任务详情：各设备执行状态 + 重试链
get_target_output	获取设备执行输出（stdout / stderr）
execute_remote_command写	批量执行远程命令（SSH / CLI 多设备并发）
execute_remote_script写	批量执行脚本（从脚本库选择）
get_job_batches	查询任务批次详情（滚动 / 金丝雀执行进度）
list_remote_scripts	查询脚本库列表（分类 / 设备类型 / 关键词）
create_remote_script写	创建运维脚本
update_remote_script写	更新运维脚本
backup_device_config写	触发配置备份（SHA-256 去重）
list_config_backups	查询配置备份列表
get_config_backup_content	获取配置备份内容
diff_config_backups	对比配置备份差异（unified diff）
get_remote_stats_overview	远程运维统计概览（任务数 / 成功率 / 平均耗时）
get_remote_stats_trend	任务趋势（按天统计）
get_remote_top_scripts	最常用脚本排名
get_remote_failure_devices	失败率最高设备排名
get_remote_efficiency	执行效率分析
list_risk_rules	列出风险评估规则（含 11 条内置规则）
create_risk_rule写	创建自定义风险规则
delete_risk_rule写	删除自定义风险规则
list_approvals	查询审批列表（高风险任务审批记录）
job_approval_action写	统一远程任务审批决策（推荐入口，approve/reject 二合一）
remote_job_control_action写	统一远程任务控制操作（推荐入口，pause/resume 二合一）
remote_job_outcome_action写	统一远程任务终态处理（推荐入口，cancel/retry 二合一）

工作流编排

8

工具名称	描述
list_workflows	查询工作流列表（模板 / 执行实例）
get_workflow_detail	工作流详情：步骤执行状态 + 输出变量
create_workflow写	创建工作流模板（DAG 步骤定义 + 变量）
update_workflow写	更新工作流模板
delete_workflow写	删除工作流
execute_workflow写	执行工作流（模板自动复制为实例）
cancel_workflow写	取消工作流及所有未完成步骤
workflow_control_action写	统一工作流控制操作（推荐入口，pause/resume 二合一）

批量操作

3

工具名称	描述
batch_import_devices写	批量导入设备 + 链路（Web 审批，分阶段执行）
poll_batch_approval	查询批量审批单状态
execute_batch_approval写	执行已审核的批量操作

IoT 设备管理

23

工具名称	描述
list_iot_models	列出物模型
get_iot_model_detail	物模型详情（含 telemetry_specs / services_schema）
get_iot_telemetry_latest	设备最新遥测值
get_iot_telemetry_history	遥测历史数据（PromQL 查询 VM）
get_iot_dashboard_summary	IoT 概览统计（在线率 / 告警 / 质量评分）
batch_config_iot_devices写	批量配置下发（按设备 ID / 标签 / 物模型）
list_iot_gateways	列出网关设备
get_gateway_children	获取网关子设备
add_gateway_child写	绑定子设备到网关
list_iot_alert_templates	列出 IoT 告警模板（含 7 个预置）
list_iot_geofences	列出地理围栏
get_geofence_events	查询围栏进出事件
list_iot_firmwares	列出固件版本
create_iot_firmware写	上传固件版本
create_ota_task写	创建 OTA 升级任务
list_ota_tasks	列出 OTA 任务
get_ota_task_detail	OTA 任务详情
get_iot_data_quality	数据质量看板（完整度 / 及时性 / 越限比例）
get_iot_heartbeat_status	IoT 设备心跳状态
bind_device_model写	绑定或解绑设备的物模型（写操作，需确认）。model_id 为 None 表示解绑
iot_model_action写	统一物模型 CRUD（推荐入口，create/update/delete 三合一）
iot_geofence_action写	统一地理围栏 CRUD（推荐入口，create/update/delete 三合一）
send_device_command写	向 IoT 设备下发控制命令（写操作，需确认）

凭据管理

7

工具名称	描述
list_credentials	列出凭据（脱敏，不返回密码原文）
get_credential_detail	凭据详情（脱敏）
create_credential写	创建凭据（SSH / SNMP / IPMI 等 10 种协议）
update_credential写	更新凭据
test_credential写	测试凭据连通性
recommend_credential	智能推荐凭据（按设备类型 / 位置 / 历史匹配）
match_credentials	自动匹配凭据（scope 优先级：device > subnet > type > global）

标签管理

4

工具名称	描述
list_tags	列出所有标签
create_tag写	创建标签
delete_tag写	删除标签
merge_tags写	合并标签（将多个标签合并为一个）

Proxy 监控代理

16

工具名称	描述
list_proxies	列出监控代理（按状态筛选）
get_proxy_detail	Proxy 详情 + 健康状态
get_proxy_health	所有 Proxy 健康状态汇总
list_proxy_tasks	Proxy 任务列表（安装 / 重启 / 升级 / 卸载）
get_proxy_config_history	Proxy 配置变更历史
install_proxy写	安装 Proxy（离线模式，自动检测 OS / 架构）
uninstall_proxy写	卸载 Proxy + ARP Helper
restart_proxy写	重启 Proxy
upgrade_proxy写	升级 Proxy（自动版本兼容性检查）
get_proxy_hosts	获取 Proxy 关联的设备列表
proxy_preflight	安装前预检（OS / Docker / 磁盘 / 端口 / 连通性）
get_proxy_health_history	Proxy 健康状态变更历史（7 天）
get_proxy_metrics	Proxy 性能指标（CPU / 内存 / 队列）
list_proxy_groups	列出 Proxy Group
manage_proxy_group写	管理 Proxy Group（创建 / 更新 / 删除）
list_auto_registration_rules	列出自动注册规则

Agent 探针管理

7

工具名称	描述
install_agent写	安装 Zabbix Agent（离线模式）
batch_install_agent写	批量安装 Agent
get_agent_status	查询 Agent 状态
uninstall_agent写	卸载 Agent
upgrade_agent写	升级 Agent
bind_template写	绑定监控模板到设备
list_recommended_templates	推荐适合设备的监控模板

IPMI 硬件管控

5

工具名称	描述
ipmi_power_action写	IPMI 电源操作（开机 / 关机 / 重启 / 重置）
get_ipmi_sensors	读取 IPMI 传感器数据（温度 / 风扇 / 电压）
get_ipmi_sel	获取 IPMI 系统事件日志
get_ipmi_fru	获取 IPMI FRU 硬件信息（序列号 / 制造商）
batch_ipmi_power写	批量 IPMI 电源操作

操作审计与回退

3

工具名称	描述
list_audit_logs	查询操作审计日志
list_recent_operations	查询可回退操作快照（回收站）
undo_operation写	恢复操作快照（撤销删除或回退修改）