🐧 Anleitung zur Installation und zum Start von Remote MCP Hub auf Linux VDS / VPS

Schnellstart-Anleitung für die Bereitstellung von Remote MCP Hub auf einem entfernten Linux-Server (Ubuntu, Debian, CentOS, AlmaLinux, Rocky, Alpine usw.) für die Verbindung von KI-Modellen (Notion AI, Claude, Cursor) im 24/7-Betrieb. Kein VPN erforderlich — Cloudflare Tunnel funktioniert direkt auf dem VDS ohne Blockierungen.

📋 Systemanforderungen

• Jeder Linux VDS / VPS-Server

• Prozessorarchitektur: x86_64 (amd64) oder ARM64

• SSH-Zugriff (Root- oder sudo-Rechte)

Related MCP server: ssh-mcp-server

⚡ Schnellstart in 2 Minuten (3 einfache Schritte)

Schritt 1. Verbinden Sie sich per SSH mit dem VDS

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

Schritt 2. Laden Sie das Projekt herunter und starten Sie die Installation

Führen Sie einen einzigen Befehl im Server-Terminal aus:

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

Das Skript führt automatisch Folgendes aus:

1. Prüft und installiert Node.js (Version 20 LTS, falls nicht installiert).

2. Installiert alle erforderlichen Abhängigkeiten (npm install).

3. Lädt das offizielle Cloudflare-Tunnel-Modul (cloudflared) herunter.

4. Generiert einen persönlichen Zugriffsschlüssel (Bearer Token).

Schritt 3. Server starten

Wählen Sie die passende Option:

Option A: Start im 24/7-Hintergrundmodus (Empfohlen)

Der Server läuft kontinuierlich im Hintergrund, auch wenn Sie das SSH-Terminal schließen:

sudo ./service.sh install

Option B: Start in der aktuellen Konsole

Für einen schnellen Start direkt im aktuellen Fenster:

./start.sh

🔑 Verbindungsdaten abrufen

Beim Start (in der Konsole oder in den Dienstprotokollen) wird sofort ein fertiger Block mit Link und Token angezeigt:

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

🔄 Server mit einem Befehl neu starten

Wenn Sie den Server neu starten und einen neuen Tunnel erhalten möchten:

./restart.sh

(Das Skript erkennt selbst die Startmethode, startet den Server korrekt neu und zeigt sofort die aktualisierte URL an).

🔌 Verbindung in Notion AI

1. Gehen Sie in den Notion-Einstellungen zum Abschnitt Custom MCP Server.

2. Füllen Sie die Felder aus:

   • MCP server URL: Fügen Sie die kopierte Adresse ein (https://...trycloudflare.com/sse)

   • Name: Geben Sie einen beliebigen Namen an (z. B. My-Linux-VDS)

   • Authentication: Wählen Sie den Typ Bearer

   • Token: Fügen Sie Ihren geheimen Schlüssel ein (beginnt mit mcp_...)

3. Klicken Sie auf die Schaltfläche «Connect» / «Save».

🧪 Testanfrage

Senden Sie eine Testnachricht an Notion AI:

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

Das KI-Modell führt Befehle auf dem Server aus und liefert den Systemstatus.

🛠️ Nützliche Verwaltungsbefehle

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

🔒 Sicherheit

• Keine weiße IP und keine offenen Ports erforderlich: Dank Cloudflare Tunnel ist der Server für das KI-Modell erreichbar, ohne Ports nach außen zu öffnen (die Firewall ist vollständig geschlossen).

• Durchgängige HTTPS-Verschlüsselung.

• Kryptografische Bearer-Autorisierung.