🐧 Instrucciones de instalación y ejecución de Remote MCP Hub en Linux VDS / VPS

Guía para el despliegue rápido de Remote MCP Hub en un servidor Linux remoto (Ubuntu, Debian, CentOS, AlmaLinux, Rocky, Alpine, etc.) para conectar redes neuronales (Notion AI, Claude, Cursor) en modo 24/7. No se requiere VPN — Cloudflare Tunnel funciona directamente en el VDS sin bloqueos.

📋 Requisitos del sistema

• Cualquier servidor Linux VDS / VPS

• Arquitectura del procesador: x86_64 (amd64) o ARM64

• Acceso por SSH (permisos de root o sudo)

Related MCP server: ssh-mcp-server

⚡ Inicio rápido en 2 minutos (3 pasos sencillos)

Paso 1. Conéctese al VDS por SSH

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

Paso 2. Descargue el proyecto e inicie la instalación

Ejecute un solo comando en la terminal del servidor:

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

El script automáticamente:

1. Verificará e instalará Node.js (versión 20 LTS, si no está instalada).

2. Instalará todas las dependencias necesarias (npm install).

3. Descargará el módulo oficial de Cloudflare Tunnel (cloudflared).

4. Generará una clave de acceso personal (Bearer Token).

Paso 3. Inicio del servidor

Elija la opción adecuada:

Opción A: Ejecución en modo 24/7 en segundo plano (Recomendado)

El servidor funcionará de forma continua en segundo plano, incluso si cierra la terminal SSH:

sudo ./service.sh install

Opción B: Ejecución en la consola actual

Para un inicio rápido directamente en la ventana actual:

./start.sh

🔑 Obtención de los datos de conexión

Al iniciar (en la consola o en los registros del servicio) se mostrará inmediatamente un bloque listo con el enlace y el token:

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

🔄 Reinicio del servidor con 1 comando

Si necesita reiniciar el servidor y obtener un nuevo túnel:

./restart.sh

(El script determinará por sí mismo el método de inicio, reiniciará el servidor correctamente y mostrará de inmediato la URL actualizada).

🔌 Conexión en Notion AI

1. En la configuración de Notion, vaya a la sección Custom MCP Server.

2. Complete los campos:

   • MCP server URL: pegue la dirección copiada (https://...trycloudflare.com/sse)

   • Name: indique cualquier nombre (por ejemplo, My-Linux-VDS)

   • Authentication: seleccione el tipo Bearer

   • Token: pegue su clave secreta (comienza con mcp_...)

3. Pulse el botón «Connect» / «Save».

🧪 Solicitud de verificación

Envíe un mensaje de prueba a Notion AI:

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

La red neuronal ejecutará los comandos en el servidor y proporcionará el estado del sistema.

🛠️ Comandos útiles de gestión

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

🔒 Seguridad

• No se necesitan IP blanca ni puertos abiertos: gracias a Cloudflare Tunnel, el servidor está disponible para la red neuronal sin abrir puertos hacia el exterior (el firewall está completamente cerrado).

• Cifrado HTTPS de extremo a extremo.

• Autorización criptográfica Bearer.