Harbor MCP Server

Harbor MCP Server (Experimental 🧪)


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

______________________________________________________________________

这是什么？

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

______________________________________________________________________

项目链接

GitHub存储库](https://github.com/bupd/harbor-mcp-server)

NPM上的港口MCP](https://www.npmjs.com/package/harbor-mcp)

Docker Hub镜像 ](https://hub.docker.com/r/bupd/harbor-mcp)

官方港口项目](https://goharbor.io)

快速开始

1. 克隆和安装：

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

1. 设置环境变量：

- 导出HARBOR_API_BASE=YOUR_HARBOR_URL（例如。 https://demo.goharbor.io/api/v2.0) - 导出HARBOR_AUTH_USER=YOUR_USERNAME - 导出HARBOR_AUTH_PASS=YOUR_PASSWORD（或令牌、秘密或任何你称之为的东西）

1. 运行：

   node build/index.js

1. 与您的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"
    }
  }
}

______________________________________________________________________

功能/命令

以下港口作业可作为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：获取系统卷信息（总大小/可用大小）。

______________________________________________________________________

贡献

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

有关更多详细信息，请查看（CONTRIBUTING.md）\[CONTRIBUTION.md\]

______________________________________________________________________

免责声明

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

______________________________________________________________________