Enables interaction with a Harbor container registry, providing tools to manage projects and repositories, monitor system health and statistics, manage storage quotas, and handle system configurations.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Harbor MCP Serverlist all repositories in the production project"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
This is an experimental, community-driven MCP server for Harbor. It is
We welcome and rely on community contributions—join us to improve and expand this tool!
What is this?
A Model Context Protocol (MCP) server for Harbor, enabling AI models and tools to interact with a Harbor container registry in real time.
Project Links
Quick Start
Clone & Install:
git clone https://github.com/bupd/harbor-mcp-server.git cd harbor-mcp-server bun install bun run buildSet Environment Variables:
export HARBOR_API_BASE=YOUR_HARBOR_URL (e.g.
https://demo.goharbor.io/api/v2.0)export HARBOR_AUTH_USER=YOUR_USERNAME
export HARBOR_AUTH_PASS=YOUR_PASSWORD (or token or secret or whatever you call it)
Run:
node build/index.jsIntegrate with your MCP client (e.g. Claude Desktop, Cursor) using the appropriate command and environment variables.
If you have it locally use the below
Run with Docker
Features / Commands
The following Harbor operations are available as MCP tools:
get-health: Check Harbor instance health.get-statistics: Get project and repository statistics.list-projects: List projects (with filters/pagination).get-project: Get details for a specific project.get-project-summary: Get a summary of a project.list-project-members: List members of a project.list-repositories-in-project: List repositories in a project.list-quotas: List storage quotas for projects.search: Search for projects and repositories by name.get-configurations: Get system configurations (admin only).update-configurations: Update system configurations (admin only, confirmation required).get-volumes: Get system volume info (total/free size).
Contributing
This project is maintained by the community, for the community.
We are looking for contributors!
Open an issue or PR to get involved.
For more details look at (CONTRIBUTING.md)[CONTRIBUTING.md]
Disclaimer
This is not an official Harbor MCP server.
It is experimental and under active development by the community.