Harbor Registry Mcp
Connects to any Harbor 2.x registry (SaaS or self-hosted) and surfaces the cleanup operations DevOps teams actually need: storage reports broken down by project and repo, cleanup candidate suggestions based on age and pull history, and bulk deletion of untagged or old artifacts. The delete tools default to dry run and carry destructive hints so Claude will ask before wiping anything. Built with FastMCP over stdio, uses Pydantic validation, and includes scan vulnerability counts when available. Differentiates itself from other Harbor MCPs by going beyond basic list and get operations to expose the disk space reclamation workflows. Authentication via robot accounts recommended.
- tools
- 8
- auth
- Secret needed
- transport
- STDIO
- env vars
- 4
- last updated
- Apr 18, 2026
Tools
8 toolsPublic tool metadata for what this MCP can expose to an agent.
harbor_list_projectsprojects with repo counts and visibility
projects with repo counts and visibility
No parameter schema in public metadata yet.
harbor_list_reposrepositories in a project
repositories in a project
No parameter schema in public metadata yet.
harbor_list_artifactsartifacts in a repository with tags/size/scan status
artifacts in a repository with tags/size/scan status
No parameter schema in public metadata yet.
harbor_storage_reportfull project storage breakdown (all repos × all artifacts)
full project storage breakdown (all repos × all artifacts)
No parameter schema in public metadata yet.
harbor_cleanup_candidatessuggest what to delete (untagged, never-pulled, old versions)
suggest what to delete (untagged, never-pulled, old versions)
No parameter schema in public metadata yet.
harbor_delete_artifactdelete a single artifact by tag or digest
delete a single artifact by tag or digest
No parameter schema in public metadata yet.
harbor_delete_untaggeddelete all untagged artifacts in a project/repo (dry-run default)
delete all untagged artifacts in a project/repo (dry-run default)
No parameter schema in public metadata yet.
harbor_delete_old_artifactskeep N latest per repo, delete the rest (dry-run default)
keep N latest per repo, delete the rest (dry-run default)
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageConfiguration
HARBOR_URL*Harbor URL (e.g. https://harbor.example.com)
HARBOR_USERNAME*Harbor username (robot account recommended for automation)
HARBOR_PASSWORD*secretHarbor password or robot account token
HARBOR_SSL_VERIFYdefault: trueVerify SSL certificates (true/false). Set to 'false' for self-signed certs.
Readme
harbor-registry-mcp
MCP server for Harbor Registry. Lets an LLM agent (Claude Code, Cursor, OpenCode, etc.) list projects, repositories and artifacts, run storage reports, find cleanup candidates, and delete untagged or old artifacts — all with safety rails (dry-run by default for bulk delete).
Python, FastMCP, stdio transport.
Works with any Harbor 2.x instance — SaaS or self-hosted / on-prem.
Why another Harbor MCP?
Details
- Repository
- github.com/mshegolev/harbor-registry-mcp
- Package
harbor-registry-mcp- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active