Harbor Registry MCP

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/mshegolev-harbor-registry-mcp

About

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.

Tools

5 read · 0 write · 3 delete

Secrets

1 (API keys, tokens or passwords)

Install scripts

Not scanned yet

Runs as

Python package

Tools (8)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

• harbor_cleanup_candidatesCleanup Candidatesread-only

  Suggest which artifacts could be deleted to reclaim space. **READ-ONLY** — never deletes anything; just produces a list with reasons. Use ``harbor_delete_artifact`` / ``harbor_delete_untagged`` / ``harbor_delete_old_artifacts`` to act on the results. Reasons emitted: - ``untagged`` — artifact has no tags (orphaned layer) - ``never_pulled`` — artifact has never been pulled (and is past the ``keep_latest_per_repo`` cutoff) - ``old_version`` — artifact is older than the ``keep_latest_per_repo`` newest tagged artifacts

• harbor_delete_artifactDelete Single Artifactcan change or delete data

  Delete a single artifact by tag or digest. **DESTRUCTIVE & IRREVERSIBLE** — Harbor immediately removes the manifest from its catalogue; the underlying blobs are reclaimed by the next GC sweep. There is no soft-delete or undo. Returns the freed space and tag list for confirmation.

• harbor_delete_old_artifactsDelete Old Artifacts (keep N)can change or delete data

  Keep the N newest artifacts in a repository, delete the rest. **DESTRUCTIVE.** ``dry_run=True`` is the default — the agent must explicitly set ``dry_run=False`` to actually delete. Each entry in ``to_delete`` carries a ``deleted`` field (``True``/``False`` after real run, ``None`` in dry-run).

• harbor_delete_untaggedDelete Untagged Artifactscan change or delete data

  Delete all untagged artifacts in a project (or single repository). **DESTRUCTIVE.** ``dry_run=True`` is the default — nothing is deleted unless the agent explicitly passes ``dry_run=False``. In dry-run no delete request is issued at all; the response lists the candidates with ``deleted=None`` and the space they would free. Untagged artifacts are typically orphaned layers left behind after pushing a new tag of the same image — generally safe to delete. The full project sweep is opaque, so the response includes ``repos_scanned`` for visibility.

• harbor_list_artifactsList Artifactsread-only

  List artifacts (tags) in a repository, newest first. Each artifact carries digest, size, push/pull timestamps, scan status and vulnerability counts (if scanned). Pagination: if ``has_more`` is ``True``, call again with ``page + 1``. For repositories with hundreds of artifacts prefer ``harbor_storage_report`` or ``harbor_cleanup_candidates`` which paginate internally.

• harbor_list_projectsList Projectsread-only

  List Harbor projects, sorted by repository count (descending *within the page*). Use this first to discover which Harbor projects exist before drilling in with ``harbor_list_repos`` / ``harbor_list_artifacts``. Pagination: if ``has_more`` is ``True``, call again with ``page + 1``. Note that sorting is per-page — agents that need a global ranking should aggregate across pages. Returns: dict with keys ``projects_count`` / ``page`` / ``page_size`` / ``has_more`` / ``next_page`` / ``projects`` (list).

• harbor_list_reposList Repositoriesread-only

  List repositories in a Harbor project. Each repository is reported with artifact count and total pull count (useful for spotting unused repos before cleanup). Pagination: if ``has_more`` is ``True``, call again with ``page + 1``.

• harbor_storage_reportStorage Reportread-only

  Full storage breakdown for a Harbor project. Iterates every repository × every artifact and returns a sorted-by-size report — the canonical view for "what's eating up our quota?". Performs O(repos × artifacts) API calls; emits progress events through MCP Context.

Signals

Stars

1

Forks

0

Open issues

0

Weekly downloads

60

Last commit

Aug 13, 2026 (2 months ago)

Last release

May 2, 2026 (6 months ago)

Last package publish

Aug 13, 2026 (2 months ago)

From GitHub (fetched Oct 24, 2026) and the package registry.

Details

Registry name

io.github.mshegolev/harbor-registry-mcp

Version

0.1.0

Auth

API key

Packages

pypi harbor-registry-mcp

License

MIT

Repository

github.com/mshegolev/harbor-registry-mcp

First seen

Oct 24, 2026

Last checked

Oct 24, 2026

Source

Official MCP Registrygithub-graphql