🚀 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 目錄後重新構建