# 🌐 Remote MCP Hub — Удаленный доступ к файлам и CMD для нейросетей

<p align="center">
  <b>Model Context Protocol (MCP) сервер с защитой по Bearer-токену, Cloudflare Tunnel и веб-панелью управления (Web UI).</b>
</p>

---

## ⚡ Быстрый старт за 3 шага

### Шаг 1. Запуск
Запустите файл **`start.bat`** двойным кликом (или в терминале `npm start`).
> Сервер автоматически установит зависимости (если их нет), запустится на порту **3800** и откроет веб-панель в браузере: **http://localhost:3800**.

### Шаг 2. Включение Cloudflare Tunnel
В открывшейся панели управления нажмите **«Запустить туннель»**:
- Вы получите публичный защищенный HTTPS-адрес: `https://<случайное_имя>.trycloudflare.com/sse`
- Скопируйте **MCP server URL** и ваш **Bearer Token**.

### Шаг 3. Подключение к нейросети (Notion, Claude, Cursor)
Вставьте полученные данные в настройки MCP-сервера в вашей нейросети:
- **MCP server URL:** `https://<ваше_имя>.trycloudflare.com/sse`
- **Authentication:** `Bearer`
- **Token:** `mcp_...`

---

## 🛠️ Доступные инструменты (MCP Tools)

| Инструмент | Описание |
|---|---|
| `execute_command` | Выполнение команд в Windows CMD / PowerShell (с выводом `stdout`, `stderr`, кода выхода и времени) |
| `list_directory` | Листинг файлов и папок с пагинацией (`limit`, `offset`) и выводом `Осталось: X файлов/папок` |
| `read_file_lines` | Построчное чтение файлов в диапазоне строк `[start_line, end_line]` с нумерацией |
| `insert_text_at_line` | Вставка текста со строки `start_line` со сдвигом остальных строк без потерь |
| `replace_text` | Точечная замена текста или фрагмента строк |
| `delete_lines` | Удаление диапазона строк со строки `start_line` по `end_line` |
| `create_file` | Создание файла с автоматическим созданием промежуточных папок |
| `delete_path` | Удаление файла или папки (с поддержкой `recursive: true`) |

---

## 🖥️ Возможности веб-интерфейса (Web UI)

- 🌐 **Cloudflare Tunnel Control**: Запуск и остановка туннеля в 1 клик с копированием ссылки.
- 🔑 **Token Manager**: Просмотр, генерация нового Bearer-токена и копирование в буфер обмена.
- 📁 **Файловый проводник и редактор**: Навигация по дискам, просмотр и редактирование файлов прямо в браузере.
- 💻 **Встроенная консоль CMD**: Тестирование терминальных команд.
- ⚡ **Журнал вызовов ИИ**: Мониторинг всех действий нейросети в реальном времени через WebSockets.

---

## 🔌 Подключение к разным клиентам

### 1. Notion AI (Custom MCP Server)
- **MCP server URL:** `https://<ваш_туннель>.trycloudflare.com/sse`
- **Name:** `pc123`
- **Authentication:** `Bearer`
- **Token:** `<ваш_токен>`

### 2. Claude Desktop (`claude_desktop_config.json`)
```json
{
  "mcpServers": {
    "my-pc-remote": {
      "url": "https://<ваш_туннель>.trycloudflare.com/sse?token=<ваш_токен>"
    }
  }
}
```

### 3. Cursor IDE (`mcp.json`)
```json
{
  "mcpServers": {
    "local-pc": {
      "type": "sse",
      "url": "https://<ваш_туннель>.trycloudflare.com/sse",
      "headers": {
        "Authorization": "Bearer <ваш_токен>"
      }
    }
  }
}
```

---

## 📤 Как выгрузить этот проект на GitHub

1. Создайте новый репозиторий на [GitHub](https://github.com/new) (например, `remote-mcp-hub`).
2. В папке проекта выполните команды в терминале:
```bash
git remote add origin https://github.com/ВАШ_ЛОГИН/remote-mcp-hub.git
git branch -M main
git push -u origin main
```