技术文档摘要

<h1 align="center" style="font-weight: bold;">Harbor MCP 服务器（实验性 🧪）</h1>

这是一个针对 Harbor 的实验性、社区驱动的 MCP 服务器。它不是官方的 Harbor 项目。
我们欢迎并依赖于社区贡献——加入我们来改进和扩展这个工具！

---

这是什么？

这是一个用于 Harbor 的模型上下文协议（MCP）服务器，使 AI 模型和工具能够实时与 Harbor 容器注册表进行交互。

---

项目链接

GitHub 仓库

Harbor-MCP 在 NPM 上

Docker Hub 镜像

官方 Harbor 项目

快速开始

1. 克隆并安装：

   git clone https://github.com/bupd/harbor-mcp-server.git
   cd harbor-mcp-server
   bun install
   bun run build
   

2. 设置环境变量：

   • export HARBOR_API_BASE=YOUR_HARBOR_URL (例如 https://demo.goharbor.io/api/v2.0)
   • export HARBOR_AUTH_USER=YOUR_USERNAME
   • export HARBOR_AUTH_PASS=YOUR_PASSWORD (或令牌或其他身份验证信息)

3. 运行：

   node build/index.js
   

4. 与你的 MCP 客户端集成（例如 Claude Desktop, Cursor），使用适当的命令和环境变量。

{
  "mcpServers": {
    "harbor": {
      "command": "npx",
      "args": [
        "-y",
        "harbor-mcp"
      ],
      "env": {
        "HARBOR_API_BASE": "HARBOR_URL",
        "HARBOR_AUTH_USER": "HARBOR_USERNAME",
        "HARBOR_AUTH_PASS": "HARBOR_PASSWORD_OR_SECRET"
      }
    }
  }
}

如果你本地有，请使用以下内容

{
  "mcpServers": {
    "harbor": {
      "command": "node",
      "args": [
        "YOUR_ABSOLUTE_PATH/harbor-mcp-server/build/index.js"
      ],
      "env": {
        "HARBOR_API_BASE": "HARBOR_URL",
        "HARBOR_AUTH_USER": "HARBOR_USERNAME",
        "HARBOR_AUTH_PASS": "HARBOR_PASSWORD_OR_SECRET"
      }
    }
  }
}

使用 Docker 运行

"mcpServers": {
  "harbor-mcp": {
    "command": "docker",
    "args": [
      "run",
      "-i",
      "--rm",
      "-e", "HARBOR_API_BASE",
      "-e", "HARBOR_AUTH_USER",
      "-e", "HARBOR_AUTH_PASS",
      "bupd/harbor-mcp-server:latest"
    ],
    "env": {
      "HARBOR_API_BASE": "YOUR_HARBOR_URL",
      "HARBOR_AUTH_USER": "YOUR_HARBOR_USERNAME",
      "HARBOR_AUTH_PASS": "YOUR_HARBOR_PASSWORD_OR_SECRET"
    }
  }
}

---

功能 / 命令

以下 Harbor 操作作为 MCP 工具可用：

• get-health：检查 Harbor 实例健康状况。
• get-statistics：获取项目和存储库统计信息。
• list-projects：列出项目（带有过滤器/分页）。
• get-project：获取特定项目的详细信息。
• get-project-summary：获取项目概要。
• list-project-members：列出项目成员。
• list-repositories-in-project：列出项目中的存储库。
• list-quotas：列出项目的存储配额。
• search：按名称搜索项目和存储库。
• get-configurations：获取系统配置（仅限管理员）。
• update-configurations：更新系统配置（仅限管理员，需要确认）。
• get-volumes：获取系统卷信息（总大小/空闲大小）。

---

贡献

• 该项目由社区维护，服务于社区。
• 我们正在寻找贡献者！
• 打开一个问题或 PR 来参与。

更多详情请查看 CONTRIBUTING.md

---

免责声明

这不是官方的 Harbor MCP 服务器。
它是实验性的，并且正在由社区积极开发中。