🌐 Remote MCP Hub (v1.2.0) — Multi-Tunnel & Proxy MCP Bridge

<p align="center"> <b>Model Context Protocol (MCP) Server with Bearer Auth, Multi-Tunnel Providers (Pinggy SSH / Cloudflare HTTP2 / Ngrok), SOCKS5/HTTP Proxy Dispatcher, and Multi-Language Web UI (EN / فارسی / RU).</b> </p>

---

✨ Key Features

• 🌍 Multi-Tunnel Architecture:
  • Pinggy (SSH on port 443): Pure JavaScript ssh2 tunnel. Uses standard TLS/HTTPS ports over TCP, effectively bypassing deep-packet inspection and QUIC/UDP blocks (especially in Iran).
  • Cloudflare Quick Tunnels: Forced --protocol http2 with fixed URL regex parser.
  • Ngrok Tunnel: Support for custom authtoken and edge tunneling.
  • Custom / VDS: Manual reverse proxy configuration.
• 🛡️ Built-in Proxy Support: Automatic routing of Node.js outbound connections and SSH tunnels through local VPN/SOCKS5/HTTP proxies (e.g. V2Ray, Xray, Sing-box on http://127.0.0.1:10809 or socks5://127.0.0.1:10808).
• 🇮🇷 Persian (فارسی) & Multilingual Web UI: Full RTL and Persian support alongside English and Russian.
• ⚡ Realtime Diagnostics & Logs: WebSockets live stream of tool calls from Notion AI, Claude, and Cursor.
• 💻 Desktop Commander Integration: 26 native MCP tools for filesystem access and Windows CMD execution.

---

⚡ Quick Start

1. Launch Server

Double-click start.bat (or execute npm start in terminal). The dashboard opens automatically at http://localhost:3800.

2. Start Tunnel

In the Web UI, select your preferred provider (e.g., Pinggy (SSH)) and click "Start Tunnel". Copy the generated public URL (e.g. https://xxxx.free.pinggy.link/sse).

3. Connect to Notion AI

1. In Notion: Settings & Members -> Connect -> Custom MCP Server.
2. Set MCP server URL to https://xxxx.free.pinggy.link/sse.
3. Set Authentication to Bearer and paste your Bearer Token.
4. Click Connect.

---

🛠️ MCP Tools

Tool	Description
execute_command	Execute commands in Windows CMD / PowerShell (returns stdout, stderr, exit code, latency)
list_directory	Directory listing with pagination and remaining counts
read_file_lines	Line-by-line reading with precise line range [start_line, end_line]
insert_text_at_line	Clean insertion of lines at specific indices without corruption
replace_text	Precise substring and line replacements
delete_lines	Remove line ranges
create_file	Create files and parent directory structures
delete_path	Safe removal of files and folders (recursive: true)