名称： veeam-mcp
描述： "通过运行在 Docker 中的 MCP 服务器查询 Veeam Backup & Replication 和 Veeam ONE。提供智能备份监控、任务分析、容量规划和基础设施健康检查。"

Veeam Intelligence MCP 技能

通过运行在 Docker 中的 MCP（模型上下文协议）服务器与 Veeam Backup & Replication (VBR) 和 Veeam ONE 进行交互。

自然语言指令

当用户提出以下类似问题时：
- “昨晚哪些备份任务失败了？”
- “显示所有虚拟机的备份状态”
- “我的备份存储库容量是多少？”
- “哪些虚拟机最近没有备份？”
- “检查 Veeam ONE 警报”
- “分析备份性能趋势”

功能概述

此技能封装了 Veeam Intelligence MCP 服务器（运行于 Docker 中），并通过自然语言提供对以下系统的访问：

Veeam Backup & Replication (VBR)：
- 备份任务状态与历史记录
- 存储库容量与健康状况
- 虚拟机备份状态
- 任务配置详情
- 失败任务分析

Veeam ONE：
- 基础设施监控
- 性能分析
- 警报管理
- 容量规划
- 趋势分析

前提条件

• 已安装并运行 Docker
• 拥有有效许可证（非社区版）的 Veeam Backup & Replication 和/或 Veeam ONE
• 在 Veeam 服务器上已启用 Veeam Intelligence（高级模式必需）
• Veeam 服务器的管理员凭据

安装步骤

1. 获取 Veeam Intelligence MCP 服务器

Veeam Intelligence MCP 服务器目前处于测试阶段。

获取方式：
- 直接联系 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

基础模式（仅文档）

如果响应显示“基础模式已激活”，请在服务器上启用 Veeam Intelligence。

用户名格式问题

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

安全说明

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

参考资源

• Veeam Intelligence MCP 服务器：联系 Veeam 获取测试版访问权限
• 模型上下文协议
• Veeam Intelligence 文档

许可证

此技能按原样提供。Veeam Intelligence MCP 服务器需单独授权。

需要帮助？ 请在 GitHub 上提交问题或在 OpenClaw Discord 中提问。