Harbor MCP服务器

一个为Harbor容器注册表提供实时交互功能的Model Context Protocol (MCP)服务器,支持AI模型和工具与Harbor的集成。

  • by bupd
  • TypeScript
  • 本地部署
  • 6 星标
  • 更新于
在 GitHub 查看 bupd/harbor-mcp-server

使用说明

Harbor MCP Server (Experimental 🧪)

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


这是什么?

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


项目链接

GitHub存储库

NPM上的港口MCP

Docker Hub镜像

官方港口项目

快速开始

  1. 克隆和安装:

    git clone https://github.com/bupd/harbor-mcp-server.git
    cd harbor-mcp-server
    bun install
    bun run build
    
  2. 设置环境变量:

    • 导出HARBOR_API_BASE=YOUR_HARBOR_URL(例如。 https://demo.goharbor.io/api/v2.0)
    • 导出HARBOR_AUTH_USER=YOUR_USERNAME
    • 导出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"
    }
  }
}

功能/命令

以下港口作业可作为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服务器。
它是实验性的,正在由社区积极开发。