🐧 Instructions for Installing and Running Remote MCP Hub on Linux VDS / VPS

A guide for quickly deploying Remote MCP Hub on a remote Linux server (Ubuntu, Debian, CentOS, AlmaLinux, Rocky, Alpine, etc.) to connect AI models (Notion AI, Claude, Cursor) in 24/7 mode. No VPN required — Cloudflare Tunnel works on VDS directly without restrictions.

📋 System Requirements

• Any Linux VDS / VPS server

• CPU architecture: x86_64 (amd64) or ARM64

• SSH access (root or sudo privileges)

⚡ Quick Start in 2 Minutes (3 Simple Steps)

Step 1. Connect to your VDS via SSH

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

Step 2. Download the project and run the installation

Run a single command in the server terminal:

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

The script will automatically:

1. Check and install Node.js (version 20 LTS if not installed).

2. Install all required dependencies (npm install).

3. Download the official Cloudflare Tunnel module (cloudflared).

4. Generate a personal access key (Bearer Token).

Step 3. Start the server

Choose the option that suits you:

Option A: Run in 24/7 background mode (Recommended)

The server will keep running continuously in the background, even if you close the SSH terminal:

sudo ./service.sh install

Option B: Run in the current console

For a quick start right in the current window:

./start.sh

🔑 Getting the connection details

On startup (in the console or in the service logs), a ready-made block with the link and token will be displayed immediately:

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

🔄 Restart the server with a single command

If you need to restart the server and get a new tunnel:

./restart.sh

(The script will detect the launch method on its own, properly reload the server, and immediately show the updated URL).

🔌 Connecting in Notion AI

1. In Notion settings, go to the Custom MCP Server section.

2. Fill in the fields:

   • MCP server URL: paste the copied address (https://...trycloudflare.com/sse)

   • Name: enter any name (e.g., My-Linux-VDS)

   • Authentication: select the Bearer type

   • Token: paste your secret key (starts with mcp_...)

3. Click the «Connect» / «Save» button.

🧪 Test request

Send a test message in Notion AI:

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

The AI will execute commands on the server and provide the system status.

🛠️ Useful management commands

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

🔒 Security

• No white-listed IPs or open ports needed: thanks to Cloudflare Tunnel, the server is accessible to the AI without opening any ports to the outside (the firewall is completely closed).

• End-to-end HTTPS encryption.

• Cryptographic Bearer authorization.