🚀 MCP 海湾码头

MCP 海湾码头是一个基于 Node.js 的应用程序，它提供了一个模型上下文协议（MCP）服务器，可用于与 Harbor 容器注册表进行交互，方便容器镜像的管理。

🚀 快速开始

MCP 海湾码头能让你轻松地与 Harbor 容器注册表进行交互。以下是快速开始使用该项目的步骤：

先决条件

Node.js 18.x 或更高版本
npm 6.x 或更高版本
Docker 安装并运行
Harbor 注册表实例

安装步骤

克隆仓库：

git clone https://github.com/nomagicln/mcp-harbor.git
cd mcp-harbor

安装依赖项：
```
npm install
```
构建项目：
```
npm run build
```

运行服务器

运行服务器：

npm start

带调试模式运行：

npm start -- --debug

环境变量配置

设置以下环境变量以配置应用程序：

HARBOR_URL：Harbor 注册表的 URL，默认为 http://localhost:80
HARBOR_USERNAME：Harbor 用户名
HARBOR_PASSWORD：Harbor 密码
DEBUG：启用调试模式，值设为 true

示例：

export HARBOR_URL=http://harbor.example.com
export HARBOR_USERNAME=admin
export HARBOR_PASSWORD=secret

✨ 主要特性

提供 MCP 协议接口，用于与 Harbor 注册表交互。
支持容器镜像的上传、下载和管理。
提供详细的错误处理和日志记录。

📦 安装指南

克隆仓库

git clone https://github.com/nomagicln/mcp-harbor.git
cd mcp-harbor

安装依赖

npm install

项目构建

npm run build

💻 使用示例

基础用法

运行服务器：

npm start

高级用法

带调试模式运行：

npm start -- --debug

通过设置环境变量配置应用程序：

export HARBOR_URL=http://harbor.example.com
export HARBOR_USERNAME=admin
export HARBOR_PASSWORD=secret

📚 详细文档

项目结构

mcp-harbor
├── src
│   ├── app.ts                 # 应用程序主入口（MCP 服务器）
│   ├── definitions
│   │   └── tool.definitions.ts # 工具定义文件（MCP）
│   ├── services
│   │   └── harbor.service.ts  # Harbor 服务实现
│   └── types
│       └── index.ts           # TypeScript 类型定义
├── test
│   └── harbor.test.ts         # 测试用例（Harbor 服务）
├── .env.example              # 环境变量示例文件
├── .gitignore               # Git 忽略文件
├── .eslintrc.json           # ESLint 配置
├── package.json            # 项目依赖管理
├── jest.config.js           # Jest 测试框架配置
├── tsconfig.test.json      # TypeScript 测试配置
├── tsconfig.json          # TypeScript 主要配置
├── LICENSE                # 项目许可证
└── README.md             # 项目文档

故障排除

常见问题

连接失败
```
错误：无法连接到 Harbor 实例
```
- 检查 HARBOR_URL 是否正确且可访问
- 确保网络连通性
- 验证 Harbor 实例是否在运行
身份验证失败
```
错误：无效凭证
```
- 检查 HARBOR_USERNAME 和 HARBOR_PASSWORD 是否正确
- 确保用户具有所需权限
构建错误
```
错误：TypeScript 编译失败
```
- 运行 npm install 以确保所有依赖项已安装
- 检查 TypeScript 版本是否兼容
- 清除 dist 目录后重新构建