Skip to content

AgentDock Bridge单人远程 MCP 桥接网关

通过 Cloudflare Workers OAuth 2.1 + PKCE 鉴权与中继,在 Windows 受保护连接器执行人工精确批准,并把操作隔离在只读 Linux Docker 沙箱中。

能力定位与明确边界 ​

能做到什么程度(已实现能力)

  • 单人 OAuth 2.1 + PKCE 远程桥接:云端拆分授权(AuthCoordinator)与长连接中继(BridgeRelay)双 SQLite DO,通过 WSS /bridge 反向连回本机,无需路由器开端口。
  • 逐参数 Approve.cmd 与先消费防重放:除 computer_context、command_status、stop_command 外,全部读写与执行工具须在本机人工确认完整参数 SHA-256 摘要,并先删 .approved.json 再记入 24 小时持久账本。
  • 10 项 MCP 工具与只读容器沙箱:运行于 --read-only、--cap-drop ALL(仅留 SETUID/SETGID)、UID/GID 1000、--network none 的一次性 Linux 容器内,并检查 Windows NTFS DACL 与 expected_sha256 CAS。

明确不能做什么(非目标与硬限制)

  • 单人属主与平台限制:仅支持单一 owner 与单个显式 /workspace 挂载,不支持多租户共享;生产凭据 loadSecrets(DPAPI)与 Windows ACL 守护明确依赖 Windows x64(Linux/macOS 仅能跑云端与回归测试)。
  • 不是端到端盲传输:Cloudflare Worker 与上游 AI 客户端平台依然可见经过 /mcp 的参数与结果正文,且已批准的工程目录内文件可被工具读取(须自行防范目录内文本提示词注入)。
  • 严格负载上限与清理闭锁:POST /mcp(仅 JSON-RPC 2.0,无 SSE 流)限制入站 1 MiB / 回包 2 MiB / 110s 超时;若 docker rm -f 清理未获确认,连接器立即闭锁拒接新任务。

系统架构全景 ​

AgentDock Bridge 拓扑视图(支持平移、缩放与节点探查)

实现口径提示:拓扑图中的外层节点概括了边缘网关到隔离沙箱的四段分工;当前源码实际采用的协议与接口为 POST /mcp(JSON-RPC 2.0,而非 SSE 流)、OAuth 2.1 + PKCE (S256)、连接器主动发起的 WSS /bridge 长连接以及本地经 Approve.cmd 确认后的 docker start --attach 容器执行。

本地验证与客户端接入摘要 ​

在 Node.js 24+ 与 pnpm@12.6.0 环境验证源码语法与跨平台测试(Linux/macOS 会自动跳过 15 项依赖 Windows DPAPI/ACL 或开启 Docker 的用例):

sh
pnpm install --frozen-lockfile
pnpm run check
pnpm test

实际生产配置须依次完成 Cloudflare Worker 部署(wrangler deploy)与 Windows x64 受保护运行副本安装(Setup.ps1 + Install-Hardened.ps1)。在远端 MCP 客户端填入你的网关端点:

text
https://<your-bridge-domain>/mcp

文档分层导航 ​

按照读者需求快速跳转