MCP Harbor
2025.04.01
1
TypeScript容器管理开发工具其它
MCP Harbor 是一个基于 Node.js 的应用，提供 Model Context Protocol (MCP) 服务器功能，用于与 Harbor 容器注册表进行交互。它支持 Harbor 的项目、仓库、标签和 Helm 图表等操作，采用 TypeScript 编写，具有良好的类型安全性和开发者体验。
View on GitHub
Overview
基本能力
产品定位
MCP Harbor 是一个用于与 Harbor 容器注册表交互的 MCP 服务器，提供了一系列工具和功能来管理和操作 Harbor 中的资源。
核心功能
- MCP Server: 通过 Model Context Protocol 提供与 Harbor 交互的工具。
- Harbor Operations: 支持对项目、仓库、标签和 Helm 图表的操作。
- TypeScript: 使用 TypeScript 编写，提供更好的类型安全性和开发者体验。
- Automated Tests: 提供全面的测试套件，确保功能的可靠性。
适用场景
- 需要自动化管理 Harbor 容器注册表的场景。
- 需要与 Harbor 进行交互的开发或运维工作流。
- 需要 TypeScript 支持的开发环境。
MCP 工具列表
| 工具名称 | 描述 | 参数 |
|---|---|---|
list_projects |
列出 Harbor 中的所有项目 | 无 |
get_project |
通过 ID 获取项目详情 | projectId: string |
create_project |
创建新项目 | project_name: string, metadata?: object |
delete_project |
删除项目 | projectId: string |
list_repositories |
列出项目中的仓库 | projectId: string |
delete_repository |
删除仓库 | projectId: string, repositoryName: string |
list_tags |
列出仓库中的标签 | projectId: string, repositoryName: string |
delete_tag |
删除标签 | projectId: string, repositoryName: string, tag: string |
list_charts |
列出 Helm 图表 | projectId: string |
list_chart_versions |
列出图表版本 | projectId: string, chartName: string |
delete_chart |
删除图表版本 | projectId: string, chartName: string, version: string |
常见问题解答
- 连接失败
- 检查 HARBOR_URL 是否正确且可访问。
- 检查网络连接。
-
确保 Harbor 实例正在运行。
-
认证失败
- 检查 HARBOR_USERNAME 和 HARBOR_PASSWORD 是否正确。
-
检查用户是否有足够的权限。
-
构建错误
- 运行
npm install确保所有依赖已安装。 - 检查 TypeScript 版本兼容性。
- 清除
dist目录并重新构建。
使用教程
使用依赖
- Node.js 18.x 或更高版本
- npm 8.x 或更高版本
- 访问 Harbor 注册表实例
- Git（用于克隆仓库）
安装教程
- 克隆仓库：
bash git clone https://github.com/nomagicln/mcp-harbor.git - 进入项目目录：
bash cd mcp-harbor - 安装依赖：
bash npm install - 构建项目：
bash npm run build
调试方式
启用调试模式：
npm run dev
或设置环境变量：
DEBUG=true