zshs000/Remote-Agent-Gateway

Self-hosted MCP gateway for lightweight outbound agents across computers, servers, CI, and edge devices.

About Remote-Agent-Gateway

Remote Agent Gateway 是一个可自行部署的远程 Agent MCP 网关。Claude、WorkBuddy、OpenClaw 或其他 MCP Client 只连接一个网关；远程电脑、服务器和 CI 运行轻量 Agent，并主动通过 WebSocket 连接回来。

远端不需要公网 IP、入站端口或 SSH，也不需要每台设备分别运行 MCP Server。

Technical Preview：当前版本已经跑通完整闭环，适合自行部署和体验。项目尚未承诺生产级稳定性，后续版本仍会快速演进，但已经发布的同名 Profile 不会静默改变契约语义。

让每台电脑、手机或边缘设备直接暴露 MCP，意味着每台设备都要处理 MCP 协议、TLS、秘钥、工具描述、客户端连接和升级。设备越多，维护成本和攻击面越大；对资源有限的设备也不现实。

- MCP Client 始终连接少量、稳定的固定工具。 - 网关负责认证、所有权、能力发现、契约校验和请求路由。 - Agent 只实现它实际加载的标准 Profile，不运行模型，也不是 MCP Server。 - Agent 主动连接网关，因此可以位于 NAT、家庭网络、CI Runner 或其他无入站网络的环境。

这不是任意 MCP Server 聚合器，也不是另一个内置模型、记忆和聊天渠道的本地 AI Agent。它只解决一件事：让上游 AI Runtime 能够发现并调用远端真实设备的标准能力。

- 注册登录、用户隔离以及独立的 MCP Access Key - 一次性 Agent Enrollment Token 和长期设备凭据 - Agent 工作台：选择 Profile，组装并下载独立 Python Agent ZIP - Agent 心跳、掉线检测、自动重连、稳定设备 ID 和版本状态 - 固定 Profile Catalog、参数校验、结果校验和 MCP 工具映射 - 每台 Agent 最多同时执行 5 个请求，第 6 个立即返回忙碌 - 每台 Shell Agent 可在网关配置命令拦截策略，默认关闭 - 原生 Web 管理端与 SQLite 持久化 - Docker Compose 自行部署

Profile Action 固定 MCP 工具 用途 ------------ shell.v1 exec remoteexec 使用 Agent 声明的系统 Shell 执行非交互命令 workspace.v1 read remotereadfile 读取工作目录内的 UTF-8 文本 workspace.v1 write remotewritefile 创建文件或按 SHA-256 安全覆盖已读取版本 workspace.v1 edit remoteeditfile 按 SHA-256 精确替换唯一文本片段

macOS / Linux 将最后两条命令中的 .\.venv\Scripts\python.exe 替换为 .venv/bin/python。

1. 注册一个账号。 2. 在“Agent 工作台”填写设备名称和用途，选择 Profile 并组装 Agent。 3. 在远程设备解压 ZIP，安装 requirements.txt，运行页面给出的一次性启动命令。 4. 回到网关确认 Agent 在线，并创建 MCP Key。 5. 把 MCP Endpoint 和 Key 配置到 Claude、WorkBuddy 或其他 MCP Client。

From the project README.

Maintaining this server?

Add the radar badge to your README — it shows your project was picked up by MCP Radar and links to this page:

[![On MCP Radar](https://mcp.liqiwa.com/badge.svg)](https://mcp.liqiwa.com/s/zshs000--Remote-Agent-Gateway.html)

Related MCP servers