Veeam Intelligence MCP 技能

通过在 Docker 中运行的 MCP（Model Context Protocol）服务器，与 Veeam Backup & Replication（VBR）和 Veeam ONE 进行交互。

自然语言命令

当用户提出如下问题时：

• “昨晚哪些备份任务失败了？”
• “显示所有虚拟机的备份状态”
• “我的备份存储库容量是多少？”
• “哪些虚拟机最近未执行备份？”
• “检查 Veeam ONE 告警”
• “分析备份性能趋势”

本技能的作用

该技能封装了在 Docker 中运行的 Veeam Intelligence MCP 服务器，提供对以下功能的自然语言访问能力：

Veeam Backup & Replication（VBR）：

• 备份任务状态与历史记录
• 存储库容量与健康状况
• 虚拟机备份状态
• 任务配置详情
• 失败任务分析

Veeam ONE：

• 基础架构监控
• 性能分析
• 告警管理
• 容量规划
• 趋势分析

先决条件

• 已安装并正在运行 Docker
• 已部署 Veeam Backup & Replication 和/或 Veeam ONE，且许可证处于激活状态（不支持 Community Edition）
• 已在您的 Veeam 服务器上启用 Veeam Intelligence（高级模式必需）
• 拥有 Veeam 服务器的管理员凭据

安装

1. 获取 Veeam Intelligence MCP 服务器

Veeam Intelligence MCP 服务器当前处于 测试版（beta） 阶段。

获取访问权限方式：

• 直接联系 Veeam 或您的 Veeam 客户代表
• 访问 Veeam 官方社区论坛
• 关注 Veeam 官方渠道发布的测试计划公告

获得 MCP 服务器软件包后，构建 Docker 镜像：

cd /path/to/veeam-mcp-server
docker build -t veeam-intelligence-mcp-server .

2. 安装本技能

clawhub install veeam-mcp

配置

创建凭据文件

创建 ~/.veeam-mcp-creds.json 文件：

{
  "vbr": {
    "url": "https://veeam-server.yourdomain.com:443/",
    "username": ".\administrator",
    "password": "your_secure_password"
  },
  "vone": {
    "url": "https://veeam-one.yourdomain.com:1239/",
    "username": ".\administrator",
    "password": "your_secure_password"
  }
}

重要提示：请严格限制凭据文件权限：

chmod 600 ~/.veeam-mcp-creds.json

用户名格式说明

• 本地账户：使用 ".\username" 格式
• 域账户：使用 "DOMAIN\username" 或 "username@domain.com"
• 反斜杠转义：JSON 中应使用单个反斜杠：".\"，而非 ".\\"

启用 Veeam Intelligence

如需执行实时数据查询（高级模式），请在 Veeam 服务器上启用 Veeam Intelligence：

Veeam Backup & Replication：

1. 打开 Veeam B&R 控制台
2. 进入 选项 → Veeam Intelligence 设置
3. 启用 AI 助手功能

Veeam ONE：

1. 打开 Veeam ONE 控制台
2. 查找 Veeam Intelligence 设置项
3. 启用该功能

若未启用此功能，所有查询将仅返回文档内容（基础模式）。

使用方法

自然语言（OpenClaw）

直接以自然语言提问即可：

"昨天哪些 Veeam 备份任务失败了？"
"显示备份存储库容量"
"检查 Veeam ONE 告警"
"本周哪些虚拟机尚未执行备份？"

命令行脚本

# 查询 VBR
./scripts/query-veeam.sh vbr "过去 24 小时内运行了哪些备份任务？"

# 查询 Veeam ONE
./scripts/query-veeam.sh vone "显示当前告警"

# 测试连接
./scripts/test-connection.sh vbr
./scripts/test-connection.sh vone

# 列出可用的 MCP 工具
./scripts/list-tools.sh vbr

工作原理

用户提问 → OpenClaw 技能 → Docker MCP 服务器 → Veeam API
                                        ↓
                               Veeam Intelligence
                                        ↓
                                 JSON 响应

1. Docker 容器：MCP 服务器在隔离容器中运行
2. STDIO 通信机制：通过标准输入/输出进行通信
3. 凭据注入：凭据由凭据文件安全注入为环境变量
4. 自然语言处理：Veeam Intelligence 利用 AI 解析并响应自然语言查询

故障排查

连接测试失败

# 检查凭据文件
cat ~/.veeam-mcp-creds.json | jq .

# 测试 Docker 镜像
docker run -i --rm veeam-intelligence-mcp-server

# 手动连接测试
echo '{"jsonrpc":"2.0","method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0.0"}},"id":1}' | 
  docker run -i --rm 
    -e PRODUCT_NAME=vbr 
    -e WEB_URL=https://your-server:443/ 
    -e ADMIN_USERNAME='.administrator' 
    -e ADMIN_PASSWORD='yourpassword' 
    -e ACCEPT_SELF_SIGNED_CERT=true 
    veeam-intelligence-mcp-server

基础模式（仅返回文档）

若响应中提示 “Basic mode is active”，请确认已在 Veeam 服务器上启用 Veeam Intelligence。

用户名格式问题

• 尝试使用 .\username（本地账户）
• 尝试使用 DOMAIN\username（域账户）
• 确保 JSON 中使用单个反斜杠

安全说明

• 凭据本地存储于 ~/.veeam-mcp-creds.json（权限设为 chmod 600）
• Docker 容器以非 root 用户身份运行
• 使用 HTTPS 连接，并支持接受自签名证书
• 日志及命令历史中不会暴露任何凭据信息
• MCP 服务器仅通过 stdin/stdout 通信

参考资料

• Veeam Intelligence MCP 服务器：请联系 Veeam 获取测试版访问权限
• Model Context Protocol
• Veeam Intelligence 文档

许可证

本技能按“现状”提供。Veeam Intelligence MCP 服务器需单独授权。

需要帮助？ 请在 GitHub 提交 Issue，或前往 OpenClaw Discord 社区提问。