Harbor AIops

Harbor AIops

通过 39 个 MCP 工具及其对应的 CLI 命令执行受治理的 Harbor 容器镜像仓库操作。每次调用都会由内置治理机制审计并计入预算。制品扫描、标签创建和高风险标签删除均提供试运行预览；无法确定的结果会报告为 outcomeUnknown。

检查内容

• 组件健康状况和系统卷使用情况。
• 项目、仓库清单、制品、标签、漏洞报告、配额和项目审计日志。
• 仓库统计信息、项目成员、标签不可变规则、标签及机器人元数据（敏感信息已隐藏）。
• 最新的全仓库扫描指标和定时扫描指标，以及有数量上限的制品扫描报告日志。
• 对一个已确认存在且可变的标签执行受保护的删除，并在操作后检查其是否已不存在。
• 垃圾回收执行历史。
• 垃圾回收执行详情和有数量上限的纯文本日志。
• 复制策略、执行记录、任务及有数量上限的任务日志。
• 根据实际 ID 查询保留策略、执行记录、任务及有数量上限的任务日志。
• harbor_diagnose 汇总健康状况、卷、垃圾回收和复制情况。探测失败会作为错误显示，且 data: null。

列表包含 items、returned、limit 和经测量得出的 truncated 字段。每次调用最多返回 500 条记录。

从源代码安装

需要 Python 3.11+、uv 和一个 Harbor 实例。使用 uv sync --dev 在本地安装。运行 uv run harbor-aiops init 配置 HTTPS 目标并加密其密码，或者创建 ~/.harbor-aiops/config.yaml，其中包含 targets 列表：

targets:
  - name: primary
    host: harbor.example.com
    username: robot$ops
    scheme: https
    port: 443
    verify_ssl: true
    timeout: 30

运行 uv run harbor-aiops secret set primary，然后运行 uv run harbor-aiops doctor 和 uv run harbor-aiops diagnose。MCP 入口为 uv run harbor-aiops-mcp。设置 HARBOR_AIOPS_MASTER_PASSWORD，以便以非交互方式访问密钥存储。默认启用 TLS 验证；ca_file 可接受自定义 CA PEM。

范围与验证

scan-artifact 命令会启动异步扫描，在检查状态之前会将最终结果报告为未知。create-tag 会确认标签此前不存在，并在写入后检查标签是否已出现。delete-tag 要求指定摘要上存在一个确切的可变标签，会预览目标，并在删除后确认标签已不存在。由于不可变规则以及后续制品变更可能导致逆向操作不安全，这两种标签写入操作都不会生成撤销令牌。在可验证实际结果和恢复路径之前，本次发布暂不支持保留策略执行、重启复制、启动/停止垃圾回收、删除制品和更改策略。请参阅验证。欢迎通过 issue 或 PR 提交缺失操作和真实环境反馈。

开发

uv run pytest -q、uv run ruff check . 和 uv run bandit -r harbor_aiops -ll 是本地检查。发布前必须通过根目录手册中的门禁检查。