Provides tools for interacting with Harbor container registry, enabling operations on projects, repositories, tags, and Helm charts such as listing, creating, and deleting resources.
Enables management of Helm charts within Harbor registry, including listing available charts, viewing chart versions, and deleting chart versions.
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.
A Node.js application that provides a Model Context Protocol server for interacting with Harbor container registry, supporting operations for projects, repositories, tags, and Helm charts.
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