🐧 Linux VDS / VPS에서 Remote MCP Hub 설치 및 실행 안내

원격 Linux 서버(Ubuntu, Debian, CentOS, AlmaLinux, Rocky, Alpine 등)에서 Remote MCP Hub를 빠르게 배포하여 신경망(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단계. 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" и выведи результат.

신경망이 서버에서 명령을 실행하고 시스템 상태를 제공합니다.

🛠️ 유용한 관리 명령

./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 인증.