MCPハーバー

ライセンス: MIT タイプスクリプト Node.js

MCP Harborは、Harborコンテナレジストリと連携するためのModel Context Protocol（MCP）サーバーを提供するNode.jsアプリケーションです。また、Harbor操作用のREST APIも含まれています。

特徴

MCP サーバー: モデルコンテキストプロトコルを介して Harbor と対話するためのツールを公開します。
REST API : Harbor操作用のRESTfulエンドポイントを提供します
Harbor Operations : プロジェクト、リポジトリ、タグ、Helm チャートの操作をサポートします
TypeScript : 型安全性と開発者エクスペリエンスを向上させるために TypeScript で記述されています
自動テスト: 信頼性の高い機能のための包括的なテストスイート

前提条件

MCP Harbor をインストールする前に、次のものを用意してください。

Node.js 18.x 以上
npm 8.x以上
Harborレジストリインスタンスへのアクセス
Git（リポジトリのクローン作成用）

インストール

リポジトリをクローンします。
git clone https://github.com/nomagicln/mcp-harbor.git
プロジェクトディレクトリに移動します。
cd mcp-harbor
依存関係をインストールします:
npm install
プロジェクトをビルドします。
npm run build
アプリケーションを起動します。
npm start

構成

環境変数

次の変数を含む.envファイルをルートディレクトリに作成します。

# Required HARBOR_URL=https://your-harbor-instance.com HARBOR_USERNAME=your_username HARBOR_PASSWORD=your_password # Optional PORT=3000 # Server port (default: 3000) LOG_LEVEL=info # Logging level (default: info) ENABLE_HTTPS=false # Enable HTTPS (default: false) SSL_CERT_PATH=/path/to/cert.pem # Required if ENABLE_HTTPS=true SSL_KEY_PATH=/path/to/key.pem # Required if ENABLE_HTTPS=true

設定ファイル

追加の構成オプションはsrc/config/harbor.config.tsで設定できます。

{ timeout: 30000, // API request timeout in milliseconds retryAttempts: 3, // Number of retry attempts for failed requests cacheEnabled: true, // Enable response caching cacheTTL: 300 // Cache TTL in seconds }

APIエンドポイント

プロジェクト

GET /projects - すべてのプロジェクトを一覧表示する
GET /projects/:id - プロジェクトの詳細を取得する
POST /projects - 新しいプロジェクトを作成する
DELETE /projects/:id - プロジェクトを削除する

リポジトリ

GET /projects/:projectId/repositories - プロジェクト内のリポジトリを一覧表示する
DELETE /projects/:projectId/repositories/:repositoryName - リポジトリを削除する

Helmチャート

GET /projects/:projectId/charts - プロジェクト内のHelmチャート一覧を取得する
GET /projects/:projectId/charts/:chartName/versions - Helm チャートのバージョンを一覧表示する
DELETE /projects/:projectId/charts/:chartName/versions/:version - Helm チャートのバージョンを削除します

MCPツール

MCP サーバーは次のツールを公開します。

ツール名	説明	パラメータ
`list_projects`	Harborのすべてのプロジェクトを一覧表示する	なし
`get_project`	IDでプロジェクトの詳細を取得する	`id: number`
`create_project`	新しいプロジェクトを作成する	`name: string, public?: boolean`
`delete_project`	プロジェクトを削除する	`id: number`
`list_repositories`	プロジェクト内のリポジトリを一覧表示する	`projectId: number`
`delete_repository`	リポジトリを削除する	`projectId: number, repoName: string`
`list_tags`	リポジトリ内のタグを一覧表示する	`projectId: number, repoName: string`
`delete_tag`	タグを削除する	`projectId: number, repoName: string, tag: string`
`list_charts`	Helm チャートの一覧表示	`projectId: number`
`list_chart_versions`	チャートのバージョンを一覧表示する	`projectId: number, chartName: string`
`delete_chart`	チャートのバージョンを削除	`projectId: number, chartName: string, version: string`

発達

開発モードで実行

npm run dev

テストの実行

# Run all tests npm test # Run tests with coverage npm run test:coverage # Run specific test file npm test -- test/harbor.test.ts

デバッグツール

プロジェクトには、 toolsディレクトリにデバッグツールが含まれています。

# Test Harbor connection npm run test:connection # Start debug server npm run debug:server

プロジェクト構造

mcp-harbor ├── src │ ├── app.ts # Main application entry point (MCP server) │ ├── config │ │ └── harbor.config.ts # Harbor configuration │ ├── controllers │ │ └── harbor.controller.ts # REST API controllers │ ├── services │ │ └── harbor.service.ts # Harbor service implementation │ ├── models │ │ └── harbor.model.ts # Data models │ ├── routes │ │ └── harbor.routes.ts # API route definitions │ └── types │ └── index.ts # TypeScript type definitions ├── test │ └── harbor.test.ts # Tests for Harbor service ├── tools │ ├── debug-server.ts # Debug server implementation │ └── test-connection.ts # Connection testing utility ├── .env.example # Example environment variables ├── .gitignore # Git ignore file ├── package.json # Project dependencies ├── tsconfig.json # TypeScript configuration └── README.md # Project documentation

トラブルシューティング

よくある問題

接続に失敗しました
Error: Unable to connect to Harbor instance
- HARBOR_URLが正しくアクセス可能であることを確認してください
- ネットワーク接続を確認する
- Harborインスタンスが実行中であることを確認する
認証に失敗しました
Error: Invalid credentials
- HARBOR_USERNAMEとHARBOR_PASSWORDが正しいことを確認してください
- ユーザーに必要な権限があるかどうかを確認する
ビルドエラー
Error: TypeScript compilation failed
- npm install実行して、すべての依存関係がインストールされていることを確認します。
- TypeScriptバージョンの互換性を確認する
- distディレクトリをクリアして再構築する

デバッグモード

次の設定によりデバッグログを有効にします。

LOG_LEVEL=debug

サポート

さらに詳しいヘルプについては、以下をご覧ください。

DEBUG.mdファイルを確認する
接続テストを実行します: npm run test:connection
logs/ディレクトリ内のアプリケーションログを確認する

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Harbor コンテナレジストリと対話するためのモデルコンテキストプロトコルサーバーを提供し、プロジェクト、リポジトリ、タグ、Helm チャートに対する操作をサポートする Node.js アプリケーション。

Related MCP Servers

Node Omnibus MCP Server
bsmi021
A
security
A
license
A
quality
A comprehensive Model Context Protocol server that provides advanced Node.js development tooling for automating project creation, component generation, package management, and documentation with AI-powered assistance.
Last updated -
7
5
MIT License
ShipStation API MCP Server
mattcoatsworth
A
security
F
license
A
quality
A comprehensive Model Context Protocol server that enables users to interact with the ShipStation API for managing orders, shipments, carriers, warehouses, products, customers, stores, webhooks, and fulfillments through structured tools.
Last updated -
39
2
ShipHero MCP Server
A
security
F
license
A
quality
A comprehensive server that enables interaction with the ShipHero API through the Model Context Protocol, providing tools for managing orders, products, inventory, shipping, warehouses, vendors, and webhooks.
MCP Clusters API Server
ayv8er
A
security
F
license
A
quality
A Model Context Protocol server implementation that provides endpoints for wallet-based authentication, cluster management, and name registration services.
Last updated -
1

View all related MCP servers

Appeared in Searches

Artifacts capabilities and features

MCP Harbor