# 🌐 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`) |