WEBUI_AUTO_OPEN.md•4.39 kB
# 🚀 Автоматическое Открытие WebUI через MCP
## ✅ Что Сделано
1. **Изменён порт по умолчанию:** `8080` → `8081` (чтобы не конфликтовать с другими проектами)
2. **Создан MCP инструмент `open_webui`** для автоматического открытия WebUI
3. **Добавлена поддержка автоматического открытия** при запуске HTTP сервера
---
## 🎯 Как Использовать
### Вариант 1: Через MCP Инструмент (Рекомендуется)
Агент может просто попросить открыть UI:
```
"Открой UI"
"Покажи WebUI"
"Открой интерфейс"
```
Агент вызовет инструмент `open_webui`, который:
- ✅ Проверит, собран ли WebUI
- ✅ Проверит, запущен ли HTTP сервер
- ✅ Автоматически запустит сервер, если нужно
- ✅ Откроет браузер с WebUI
### Вариант 2: Автоматическое Открытие при Запуске
Установи переменную окружения:
```bash
export AUTO_OPEN_WEBUI=true
```
Затем запусти HTTP сервер:
```bash
cd /Users/Gyber/GYBERNATY-ECOSYSTEM/TRADER-AGENT/bybit-mcp
pnpm start:http
```
WebUI автоматически откроется в браузере через 1 секунду после запуска сервера.
---
## 📋 MCP Инструмент: `open_webui`
### Параметры:
- `autoStart` (boolean, default: true) - Автоматически запускать HTTP сервер, если не запущен
- `port` (number, default: 8081) - Порт для WebUI
### Пример использования:
```json
{
"name": "open_webui",
"arguments": {
"autoStart": true,
"port": 8081
}
}
```
### Ответ:
```json
{
"success": true,
"message": "WebUI opened successfully",
"url": "http://localhost:8081",
"serverRunning": true,
"autoStarted": false
}
```
---
## 🔧 Настройка
### Изменить Порт
**Через переменную окружения:**
```bash
export MCP_HTTP_PORT=8082
pnpm start:http
```
**Через параметр инструмента:**
```json
{
"name": "open_webui",
"arguments": {
"port": 8082
}
}
```
### Отключить Автоматический Запуск Сервера
```json
{
"name": "open_webui",
"arguments": {
"autoStart": false
}
}
```
В этом случае инструмент только откроет браузер, если сервер уже запущен.
---
## 🌐 URL WebUI
После запуска WebUI будет доступен по адресу:
```
http://localhost:8081
```
(или по указанному порту)
---
## ⚙️ Интеграция в Cursor MCP
Инструмент `open_webui` автоматически доступен через MCP сервер `bybit-analysis`.
Агент может использовать его так:
```
User: "Открой UI"
Agent: [вызывает open_webui]
→ WebUI открывается в браузере
```
---
## 🎯 Примеры Использования
### 1. Простое открытие
```
User: "Покажи интерфейс"
Agent: Использует open_webui → WebUI открывается
```
### 2. С указанием порта
```
User: "Открой UI на порту 9000"
Agent: Использует open_webui с port: 9000
```
### 3. Без автозапуска сервера
```
User: "Открой UI, но не запускай сервер"
Agent: Использует open_webui с autoStart: false
```
---
## ✅ Статус
- ✅ Порт изменён на 8081
- ✅ MCP инструмент `open_webui` создан
- ✅ Автоматическое открытие браузера при запуске (опционально)
- ✅ Проверка сборки WebUI
- ✅ Автоматический запуск HTTP сервера
- ✅ Поддержка всех платформ (macOS, Windows, Linux)
**Готово к использованию!** 🚀