My Vps Agent Terminal

myVpsAgent终端

用于VPS的自托管MCP shell服务器——通过HTTPS从Cursor AI控制您的服务器。

让您的Cursor AI代理完全访问您的VPS。运行任何命令、管理Docker容器、读取日志——所有这些都来自Cursor中的自然语言聊天。

运作原理

Cursor AI (local)
      ↕ HTTPS + Bearer token
Apache / Nginx (your VPS)
      ↕ HTTP (localhost only)
MCP Shell container (127.0.0.1:PORT)
      ↕
bash

您的MCP容器永远不会直接暴露在互联网上，只有您现有的反向代理是这样。

先决条件

• Ubuntu/Debian虚拟专用服务器
• Docker+Docker组合
• 阿帕奇 或 Nginx已安装
• openssl 已安装(sudo apt install openssl)

安装

git clone https://github.com/bannik62/myVpsAgent-terminal.git
cd myVpsAgent-terminal
sudo ./install.sh

该脚本将指导您完成：

1. 反向代理检测 --自动检测Apache或Nginx
2. 域名/SSL --3个选项：

- 已配置现有域+Let's Encrypt - 现有域名+自动证书机器人 - 仅限IP+自签名证书

1. 端口选择 --显示已占用的端口，建议使用空闲端口
2. 令牌生成 --自动生成一个安全的32字节令牌
3. 配置输出 --打印 mcp.json 代码段已准备好粘贴到游标中

在安装结束时，您将得到类似以下内容：

{
  "mcpServers": {
    "vps-shell": {
      "url": "https://yourdomain.fr/mcp/shell",
      "transport": "http",
      "headers": {
        "Authorization": "Bearer "
      }
    }
  }
}

将此粘贴到 ~/.cursor/mcp.json 并重新启动Cursor。

用法

连接后，向Cursor询问任何问题：

"Show me running Docker containers"
"Tail the last 50 lines of the nginx error log"
"How much disk space is left?"
"Restart the zerok-backend container"
"Show me the apache config for codeurbase.fr"

安全

• MCP容器正在监听 127.0.0.1 只是——从未接触过互联网
• 所有请求都需要 Bearer 令牌在 Authorization 头球
• Apache/Nginx返回 403 对于任何没有正确令牌的请求
• 对你的代币保密 --它允许shell访问您的服务器

续订令牌

# Generate a new token
NEW_TOKEN=$(openssl rand -hex 32)

# Update .env
sed -i "s/^MCP_TOKEN=.*/MCP_TOKEN=${NEW_TOKEN}/" .env

# Regenerate reverse proxy config and reload
sudo ./install.sh --reload

# Update your ~/.cursor/mcp.json with the new token

卸载

sudo ./uninstall.sh

这将：

• 停止并删除Docker容器
• 删除反向代理配置
• （可选）删除自签名证书
• 删除 .env 文件

项目结构

myVpsAgent-terminal/
├── server.js                           ← MCP server (Node.js, HTTP streamable)
├── Dockerfile                          ← node:22-alpine image
├── docker-compose.yml                  ← container config (reads .env)
├── package.json
├── install.sh                          ← interactive installer
├── uninstall.sh                        ← clean uninstaller
├── .env.example                        ← environment variables template
└── templates/
    ├── apache.conf.template            ← Apache + Let's Encrypt
    ├── apache-selfsigned.conf.template ← Apache + self-signed
    ├── nginx.conf.template             ← Nginx + Let's Encrypt
    └── nginx-selfsigned.conf.template  ← Nginx + self-signed

许可证

麻省理工学院