🐧 在 Linux VDS / VPS 上安装和运行 Remote MCP Hub 的说明

在远程 Linux 服务器（Ubuntu、Debian、CentOS、AlmaLinux、Rocky、Alpine 等）上快速部署 Remote MCP Hub 的指南，用于以 24/7 模式连接 AI 模型（Notion AI、Claude、Cursor）。 无需 VPN — Cloudflare Tunnel 可直接在 VDS 上运行，不受封锁。

📋 系统要求

• 任意 Linux VDS / VPS 服务器

• 处理器架构：x86_64 (amd64) 或 ARM64

• 通过 SSH 访问（root 或 sudo 权限）

Related MCP server: ssh-mcp-server

⚡ 2 分钟快速启动（3 个简单步骤）

步骤 1. 通过 SSH 连接到 VDS

ssh root@<IP_ВАШЕГО_СЕРВЕРА>

步骤 2. 下载项目并启动安装

在服务器终端中执行一条命令：

git clone https://github.com/etern1ty-crypto/remote-mcp-hub-linux.git && cd remote-mcp-hub-linux && chmod +x *.sh && ./install.sh

脚本将自动：

1. 检查并安装 Node.js（如果未安装，则安装 20 LTS 版本）。

2. 安装所有必要的依赖（npm install）。

3. 下载官方 Cloudflare Tunnel 模块（cloudflared）。

4. 生成个人访问密钥（Bearer Token）。

步骤 3. 启动服务器

选择合适的选项：

方案 A：以 24/7 模式在后台运行（推荐）

即使您关闭 SSH 终端，服务器也会在后台持续运行：

sudo ./service.sh install

方案 B：在当前控制台中运行

用于在当前窗口中快速启动：

./start.sh

🔑 获取连接信息

启动时（在控制台或服务日志中）将立即显示包含链接和令牌的完整信息块：

=============================================================================
🟢 Cloudflare Tunnel успешно активен!
📡 MCP Server URL для подключения нейросети (Notion AI / Claude / Cursor):
   👉 https://xxxxxxxx.trycloudflare.com/sse
🔑 Bearer Token:
   👉 mcp_xxxxxxxxxxxxxxxxxxxxxxxxxxxx
=============================================================================

🔄 一条命令重启服务器

如果您需要重启服务器并获取新的隧道：

./restart.sh

（脚本将自动确定启动方式，正确重启服务器并立即显示更新后的 URL）。

🔌 在 Notion AI 中连接

1. 在 Notion 设置中，进入 Custom MCP Server 部分。

2. 填写字段：

   • MCP server URL: 粘贴复制的地址（https://...trycloudflare.com/sse）

   • Name: 指定任意名称（例如，My-Linux-VDS）

   • Authentication: 选择类型 Bearer

   • Token: 粘贴您的密钥（以 mcp_... 开头）

3. 点击 「Connect」 / 「Save」 按钮。

🧪 测试请求

向 Notion AI 发送测试消息：

Привет! Проверь подключение к моему VDS: выполни команду "uname -a && uptime && free -h && df -h" и выведи результат.

AI 模型将在服务器上执行命令并提供系统状态。

🛠️ 有用的管理命令

./restart.sh                 # 🔄 Перезапуск сервера в одну команду
sudo ./service.sh logs       # 📜 Просмотр логов и URL туннеля в реальном времени (Ctrl+C для выхода)
sudo ./service.sh status     # 📊 Проверить состояние фоновой службы
sudo ./service.sh stop       # ⏹️ Остановить службу
sudo ./service.sh uninstall  # ❌ Полностью удалить службу из системы

🔒 安全性

• 无需白名单 IP 和开放端口： 得益于 Cloudflare Tunnel，服务器无需对外开放端口即可供 AI 模型访问（防火墙完全关闭）。

• 端到端 HTTPS 加密。

• 加密 Bearer 授权。