MCP Harbor

🚀 MCP 海灣碼頭

MCP 海灣碼頭は、Node.js をベースにしたアプリケーションで、Harbor コンテナレジストリとのやり取りに使用するモデルコンテキストプロトコル（MCP）サーバーを提供します。

🚀 クイックスタート

MCP 海灣碼頭は、Harbor コンテナレジストリとのやり取りを容易にするためのアプリケーションです。以下の手順に従って、すぐに始めることができます。

✨ 主な機能

• Harbor レジストリとのやり取りに使用する MCP プロトコルインターフェースを提供します。
• コンテナイメージのアップロード、ダウンロード、管理をサポートします。
• 詳細なエラー処理とログ記録を提供します。

📦 インストール

1. リポジトリをクローンする

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

2. 依存関係をインストールする

npm install

3. プロジェクトをビルドする

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
├── 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             # プロジェクトのドキュメント

トラブルシューティング

一般的な問題

1. 接続エラー

エラー：Harbor インスタンスに接続できません

• HARBOR_URL が正しく、アクセス可能かどうかを確認します。
• ネットワーク接続が正常かどうかを確認します。
• Harbor インスタンスが実行中かどうかを確認します。

2. 認証エラー

エラー：無効な資格情報です

• HARBOR_USERNAME と HARBOR_PASSWORD が正しいかどうかを確認します。
• ユーザーが必要な権限を持っていることを確認します。

3. ビルドエラー

エラー：TypeScript のコンパイルに失敗しました

• npm install を実行して、すべての依存関係がインストールされていることを確認します。
• TypeScript のバージョンが互換性があることを確認します。
• dist ディレクトリをクリアしてから、再度ビルドします。

デバッグモード

デバッグモードを有効にするには、次のコマンドを使用します。

--debug

または、環境変数を設定します。

DEBUG=true

サポート

ヘルプが必要な場合は、アプリケーションのログを参照してください。

📄 ライセンス

このプロジェクトは MIT ライセンスの下で提供されています。詳細は LICENSE ファイルを参照してください。