🐧 Инструкция по установке и запуску Remote MCP Hub на Linux VDS / VPS

Руководство по быстрому развертыванию Remote MCP Hub на удаленном Linux-сервере (Ubuntu, Debian, CentOS, AlmaLinux, Rocky, Alpine и др.) для подключения нейросетей (Notion AI, Claude, Cursor) в режиме 24/7. VPN не требуется — Cloudflare Tunnel работает на VDS напрямую без блокировок.

📋 Системные требования

• Любой Linux VDS / VPS сервер

• Архитектура процессора: x86_64 (amd64) или ARM64

• Доступ по SSH (права root или sudo)

Related MCP server: ssh-mcp-server

⚡ Быстрый запуск за 2 минуты (3 простых шага)

Шаг 1. Подключитесь к VDS по SSH

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. Запуск сервера

Выберите подходящий вариант:

Вариант А: Запуск в режиме 24/7 в фоне (Рекомендуется)

Сервер будет работать непрерывно в фоне, даже если вы закроете SSH-терминал:

sudo ./service.sh install

Вариант Б: Запуск в текущей консоли

Для быстрого запуска прямо в текущем окне:

./start.sh

🔑 Получение данных для подключения

При запуске (в консоли или в логах службы) сразу отобразится готовый блок с ссылкой и токеном:

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

🔄 Перезапуск сервера в 1 команду

Если вам нужно перезапустить сервер и получить новый туннель:

./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" и выведи результат.

Нейросеть выполнит команды на сервере и предоставит статус системы.

🛠️ Полезные команды управления

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

🔒 Безопасность

• Белый IP и открытые порты не нужны: благодаря Cloudflare Tunnel сервер доступен нейросети без открытия портов наружу (фаервол полностью закрыт).

• Сквозное HTTPS-шифрование.

• Криптографическая Bearer-авторизация.