MCP Harbor
MCP Harbor is a Node.js application that provides a Model Context Protocol (MCP) server for interacting with Harbor container registry.
Table of Contents
Features
- MCP Server: Exposes tools for interacting with Harbor through the Model Context Protocol
- Harbor Operations: Supports operations for projects, repositories, tags, and Helm charts
- TypeScript: Written in TypeScript for better type safety and developer experience
- Automated Tests: Comprehensive test suite for reliable functionality
Prerequisites
Before installing MCP Harbor, ensure you have:
- Node.js 18.x or higher
- npm 8.x or higher
- Access to a Harbor registry instance
- Git (for cloning the repository)
Installation
- Clone the repository:
- Navigate to the project directory:
- Install dependencies:
- Build the project:
Usage
Command Line Arguments
The application accepts the following command line arguments:
Environment Variables
Instead of command line arguments, you can also use environment variables. Create a .env
file in the root directory:
MCP Tools
The MCP server exposes the following tools:
Tool Name | Description | Parameters |
---|---|---|
list_projects | List all projects in Harbor | None |
get_project | Get project details by ID | projectId: string |
create_project | Create a new project | project_name: string, metadata?: object |
delete_project | Delete a project | projectId: string |
list_repositories | List repositories in a project | projectId: string |
delete_repository | Delete a repository | projectId: string, repositoryName: string |
list_tags | List tags in a repository | projectId: string, repositoryName: string |
delete_tag | Delete a tag | projectId: string, repositoryName: string, tag: string |
list_charts | List Helm charts | projectId: string |
list_chart_versions | List chart versions | projectId: string, chartName: string |
delete_chart | Delete chart version | projectId: string, chartName: string, version: string |
Development
Running in Development Mode
Running Tests
Project Structure
Troubleshooting
Common Issues
- Connection Failed
- Verify HARBOR_URL is correct and accessible
- Check network connectivity
- Ensure Harbor instance is running
- Authentication Failed
- Verify HARBOR_USERNAME and HARBOR_PASSWORD are correct
- Check if user has required permissions
- Build Errors
- Run
npm install
to ensure all dependencies are installed - Check TypeScript version compatibility
- Clear the
dist
directory and rebuild
- Run
Debug Mode
Enable debug mode by using the --debug
flag or setting:
Support
For additional help:
- Review the application logs
License
This project is licensed under the MIT License - see the LICENSE file for details.
This server cannot be installed
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
- AsecurityAlicenseAqualityA 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 -74MIT License
- AsecurityFlicenseAqualityA 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 -392
- AsecurityFlicenseAqualityA 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.Last updated -29
- AsecurityFlicenseAqualityA Model Context Protocol server implementation that provides endpoints for wallet-based authentication, cluster management, and name registration services.Last updated -1