MCP Harbour

Dock your servers once, control which agents can access which tools, and manage everything from a single place.

Built as an implementation of the GPARS plane boundary.

______________________________________________________________________

安装

Linux/macOS：

curl -fsSL https://mcpharbour.ai/install.sh | bash

Windows（PowerShell）：

irm https://mcpharbour.ai/install.ps1 | iex

这将下载二进制文件，将守护进程注册为系统服务，并启动它。不需要Python或包管理器。

或者直接从以下网址下载二进制文件 .

快速开始

# 1. Dock an MCP server
harbour dock --name filesystem \
  --command "npx -y @modelcontextprotocol/server-filesystem /home/user/projects"

# 2. Create an identity
harbour identity create my-agent

# 3. Grant permissions
harbour permit allow my-agent filesystem --tool "*" --args "path=/home/user/projects/**"

然后配置您的MCP客户端（Claude Code、VS Code、Cursor、OpenCode）：

{
  "mcpServers": {
    "harbour": {
      "url": "http://127.0.0.1:4767/mcp",
      "headers": {
        "Authorization": "Bearer harbour_sk_..."
      }
    }
  }
}

运作原理

Agent → Streamable HTTP /mcp → Harbour Daemon → MCP Servers
              │                       │
          Bearer auth          identity verification
                               policy enforcement
                               AUTHORIZATION_DENIED / SERVER_UNAVAILABLE

• 默认拒绝 --没有策略意味着没有访问权限
• 令牌身份 --代理人不能自我维护自己的身份
• 按代理政策 --服务器、工具和参数约束的白名单
• 进程隔离 --每个代理都有自己的MCP服务器进程
• GPARS错误代码 — AUTHORIZATION_DENIED （-31001）以及 SERVER_UNAVAILABLE (-31002)

文档

阅读完整文档 docs.mcpharbour.ai

贡献

看 贡献.md 用于开发设置和指南。

作者

伊斯梅尔·凯西

许可证

该项目根据 MIT许可证.