# Harbor

> Harbor is an open-source MCP server for developer tools. Read-only MCP server for Harbor container registries: projects, scans, robots, replication. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Website:** https://www.oreonit.com/harbor-mcp/
- **Repository:** https://github.com/oreondev/harbor-mcp
- **MCP Registry name:** io.github.oreondev/harbor-mcp
- **Categories:** developer tools, cloud and infrastructure
- **Listing updated:** 2026-11-14

## About

This is an independent community project, not affiliated with the Harbor project or the CNCF. It connects an assistant to a running Harbor instance and answers questions about quotas, artifacts, scan results, access and replication health, using fourteen tools that only read.

It authenticates with a Harbor user or robot account, and the README recommends a read-only system robot, with a ready-made request body for creating one. Harbor credentials, robot secrets and webhook authorization headers are kept out of tool results, logs and errors. No tool deletes anything; write tools such as starting a scan or replication are described as coming later and only with explicit opt-in.

A distinctive part is support for agent skills stored in Harbor as OCI artifacts: the server can list and show them, and when HARBOR_MCP_SKILLS_DIR is set it can install one locally, accepting signed skills only by default. It runs over stdio for desktop clients, or streamable HTTP with a bearer token inside a cluster, and ships as a signed multi-arch image.

## Features

- **Vulnerability reports:** Returns the vulnerabilities of one artifact, worst first.
- **Project details:** Shows quota, CVE allowlist, retention and immutability settings.
- **Access review:** Lists project members with roles and robot accounts with permissions and expiry.
- **Replication status:** Lists registries and replication policies along with the last run.
- **Agent skills:** Lists and reads skills stored in Harbor, with digest and signature status.
- **Opt-in skill install:** Writes a skill into a local directory only when HARBOR_MCP_SKILLS_DIR is set.
- **Secret hygiene:** Keeps credentials and webhook headers out of results, logs and errors.

## Good for

- Ask which images in a project carry the worst vulnerabilities
- Audit which robot accounts exist and when they expire
- Check whether replication jobs ran successfully
- Pull agent skills from Harbor into a local skills folder

## Install

### Claude Code (Terminal)

```sh
claude mcp add harbor-mcp --env HARBOR_URL='<HARBOR_URL>' --env HARBOR_USERNAME='<HARBOR_USERNAME>' --env HARBOR_PASSWORD='<HARBOR_PASSWORD>' -- docker run -i --rm -e HARBOR_URL -e HARBOR_USERNAME -e HARBOR_PASSWORD ghcr.io/oreondev/harbor-mcp:0.2.0
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "harbor-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "HARBOR_URL",
        "-e",
        "HARBOR_USERNAME",
        "-e",
        "HARBOR_PASSWORD",
        "ghcr.io/oreondev/harbor-mcp:0.2.0"
      ],
      "env": {
        "HARBOR_URL": "<HARBOR_URL>",
        "HARBOR_USERNAME": "<HARBOR_USERNAME>",
        "HARBOR_PASSWORD": "<HARBOR_PASSWORD>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "harbor-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "HARBOR_URL",
        "-e",
        "HARBOR_USERNAME",
        "-e",
        "HARBOR_PASSWORD",
        "ghcr.io/oreondev/harbor-mcp:0.2.0"
      ],
      "env": {
        "HARBOR_URL": "<HARBOR_URL>",
        "HARBOR_USERNAME": "<HARBOR_USERNAME>",
        "HARBOR_PASSWORD": "<HARBOR_PASSWORD>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "harbor-mcp": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "HARBOR_URL",
        "-e",
        "HARBOR_USERNAME",
        "-e",
        "HARBOR_PASSWORD",
        "ghcr.io/oreondev/harbor-mcp:0.2.0"
      ],
      "env": {
        "HARBOR_URL": "<HARBOR_URL>",
        "HARBOR_USERNAME": "<HARBOR_USERNAME>",
        "HARBOR_PASSWORD": "<HARBOR_PASSWORD>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "harbor-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "HARBOR_URL",
        "-e",
        "HARBOR_USERNAME",
        "-e",
        "HARBOR_PASSWORD",
        "ghcr.io/oreondev/harbor-mcp:0.2.0"
      ],
      "env": {
        "HARBOR_URL": "<HARBOR_URL>",
        "HARBOR_USERNAME": "<HARBOR_USERNAME>",
        "HARBOR_PASSWORD": "<HARBOR_PASSWORD>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "harbor-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "HARBOR_URL",
        "-e",
        "HARBOR_USERNAME",
        "-e",
        "HARBOR_PASSWORD",
        "ghcr.io/oreondev/harbor-mcp:0.2.0"
      ],
      "env": {
        "HARBOR_URL": "<HARBOR_URL>",
        "HARBOR_USERNAME": "<HARBOR_USERNAME>",
        "HARBOR_PASSWORD": "<HARBOR_PASSWORD>"
      }
    }
  }
}
```

## Tools

- `harbor_system_info`: Harbor version, authentication mode and the acting user or robot.
- `harbor_list_projects`: Lists projects.
- `harbor_get_project`: Quota, CVE allowlist, retention and immutability of one project.
- `harbor_list_repositories`: Lists repositories.
- `harbor_list_artifacts`: Artifacts with tags, size, push and pull times and scan summary.
- `harbor_get_vulnerabilities`: Vulnerabilities of one artifact, worst first.
- `harbor_list_members`: Members with roles.
- `harbor_list_robots`: Robot accounts with permissions and expiry.
- `harbor_list_registries`: Replication endpoints.
- `harbor_list_replications`: Replication policies with the last run.
- `harbor_list_webhooks`: Webhook policies.
- `harbor_get_gc`: Garbage collection schedule.
- `harbor_list_skills`: Agent skills stored in a project as OCI artifacts.
- `harbor_get_skill`: One skill's SKILL.md and files, digest and signature status.
- `harbor_install_skill`: Installs a skill into HARBOR_MCP_SKILLS_DIR when that is set.

## FAQ

### Can it change anything in Harbor?

No. The README says the tools are read-only and none deletes anything; write tools may come later behind an explicit opt-in.

### Which Harbor versions are tested?

The README lists tests against Harbor 2.15 on every pull request and 2.12 to 2.15 nightly.

### What credentials does it need?

HARBOR_URL, HARBOR_USERNAME and HARBOR_PASSWORD; a read-only system robot is recommended.

### How is it transported?

Over stdio for desktop clients, or streamable HTTP with a bearer token for running in a cluster.

### Is Harbor free?

Yes. Harbor is open source, so you can use and self-host it for free.

### How do I add Harbor to Claude Code?

Run this command in your terminal: claude mcp add harbor-mcp --env HARBOR_URL='<HARBOR_URL>' --env HARBOR_USERNAME='<HARBOR_USERNAME>' --env HARBOR_PASSWORD='<HARBOR_PASSWORD>' -- docker run -i --rm -e HARBOR_URL -e HARBOR_USERNAME -e HARBOR_PASSWORD ghcr.io/oreondev/harbor-mcp:0.2.0

### What are the best alternatives to Harbor?

The closest alternatives to Harbor are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/harbor-2
