AI VPS Gateway
LOCAL ONLY GitHub

本机优先的 MCP 控制平面

运维 跟上 上下文。

让 Codex 和 Claude Code 通过一个本机网关，管理你的 VPS、项目与运维知识。

下载 macOS 版本 查看源代码
SIGNAL / 01 LIVE
SESSION LEASED
TARGET VPS / 04
AUDIT READY

私钥留在你的 Mac。AI 只获得被记录的执行路径。

向下探索 31°13' / 121°28' 01 / 06

展示图使用仓库内演示数据和保留 IP 地址。

01ONE LOCAL OPERATIONS CONTEXT

不是再造一个 终端。 是让每一次 动手 都有上下文。

服务器、端口、运行方式、公开入口和变更边界不再散落在不同会话里。网关把它们连成可查询、可审计的本机运维上下文。

01 / VPS

先知道它活着

TCP、SSH Banner 和 HTTP(S) 共同判断状态，不把 ICMP Ping 当成唯一答案。

HEALTH / METRICS
02 / PROJECTS

再知道该碰什么

技术栈、服务、端口、域名入口和排错顺序，留在能被下一次会话读懂的项目档案里。

RUNBOOK / CONTEXT
03 / MCP

最后让 AI 动手

每台 VPS 独占租约，会话排队，命令脱敏审计，私钥永远不进入 Codex 或 Claude。

LEASE / AUDIT
02VPS INVENTORY / SIGNALS

一台 VPS 可以没有网站，但不能没有状态。

手动登记资产，完成 SSH 绑定，再让网关按 TCP、SSH Banner 和 HTTP(S) 检查状态。性能快照和趋势留在本机，不需要给每台服务器安装常驻 Agent。

  • 不把 ICMP Ping 当成唯一在线判据
  • 直连模式可绕过本机 TUN 的 SSH 误告警
  • CPU、内存、磁盘与负载的历史趋势
gateway / overview1440 × 980
演示数据中的服务器仪表盘，展示健康状态和性能趋势
VPS 清单、非 ICMP 依赖的测活、当前性能和阈值告警。01
gateway / projectRUNBOOK
演示项目的运维 Runbook、技术栈和服务清单
项目档案将服务、端口、入口与 Runbook 保留在同一个本机记录中。02
03PROJECT CONTEXT / RUNBOOK

每次部署，留下下一位维护者能用的答案。

项目档案保存技术栈、服务管理器、端口映射、Web 入口和五段式 Runbook。后续 AI 会话先读上下文，再申请会话和执行操作。

Docker systemd PM2 Nginx
查看项目结构
04A SMALLER OPERATIONS LOOP

从首次绑定，到一次可复盘的 AI 运维。

  1. 01

    添加并绑定

    新 VPS 自动生成专用公钥。你只需通过云控制台或已有入口完成一次安装，再点击测试绑定。

  2. 02

    盘点并沉淀

    只读盘点 Docker、systemd、PM2、端口和 Nginx 路由，生成可编辑的项目档案与 Runbook。

  3. 03

    AI 申请独占会话

    同一台 VPS 同时仅一个执行会话，其余请求排队。AI 不会得到私钥或本机任意 SSH 路径。

  4. 04

    执行后可追溯

    命令、结果和高危提示经过脱敏后进入审计记录，运维摘要与 Runbook 留作后续上下文。

MCP / SESSION open_session → run_command → audit → close_session READY
05SECURITY MODEL / NO MARKETING CLAIMS

No key. No guessing. No loose ends.

本机控制边界，不是“绝对安全”的包装。每一次执行都要经过网关、租约和审计。

A / 01

私钥不交给 AI

凭据由本机网关持有，MCP 客户端只能请求受控操作。

A / 02

受租约的 SSH 执行

每台 VPS 有独占会话、排队、空闲超时和最长时限。

A / 03

高危操作可见

常见不可逆命令被阻断，高危行为留下审计警告。

A / 04

边界说清楚

它不是 OS 沙箱。同一 macOS 用户下的不受信任进程仍应被隔离。

06MAKE THE NEXT ACTION OBVIOUS

先读状态，再让 Agent 动手。

网关为后续会话提供当前性能、健康检查、项目关联与已执行操作。AI 的执行入口仍是 MCP，而不是把私钥复制进每一个会话。

查看 MCP 使用方式
gateway / metricsLOCAL HISTORY
演示 VPS 的健康检查、性能趋势和 AI 会话状态
性能、健康、项目盘点和 AI 会话在同一台 VPS 详情中汇合。03
OPENOPEN SOURCE / LOCAL BY DEFAULT

让本机成为你的控制平面。

桌面客户端把本机 API、WebUI、MCP 适配器和菜单栏入口合在一起。源码模式同样保持 API 仅监听 loopback。

下载最新 macOS 版本 在 GitHub 查看项目
QUICK STARTLOCAL / STDIO
$ npm install
$ npm run dev

# Register the local MCP adapter
$ codex mcp add ai-vps-gateway -- npm --prefix
  /path/to/ai-vps-gateway run mcp
MCP / loopback / auditable