suno-mcp-server/NexusAI/TEST_RESUME.md

NexusAI — полное резюме тестов

Дата: 2026-08-18
Репозиторий: /home/user/moder/mcp/NexusAI
Ветка: main
Админка: http://127.0.0.1:4123

---

1. Общая архитектура

Проект — универсальный MCP-сервис для агентов:

• packages/core — журнал SQLite, шифрование ключей, медиа-хранилище, провайдеры.
• packages/mcp-server — MCP stdio-сервер с инструментами nexus_*.
• packages/admin — Fastify web UI (дашборд, галерея, управление провайдерами).
• sidecar/stt_server.py — локальный faster-whisper sidecar.

Провайдер по умолчанию — NordRouter (https://nordrouter.com). Ключи хранятся в SQLite, зашифрованные мастер-ключом NEXUS_MASTER_KEY.

Переменные окружения, использованные в тестах

NEXUS_MEDIA_DIR=/tmp/opencode/nexus-media
NEXUS_MASTER_KEY=fixed-test-master-key-1234567890
NEXUS_ADMIN_PORT=4123
NEXUS_STT_MODEL=/tmp/opencode/whisper-tiny
NEXUS_STT_LOCAL_ONLY=1
NEXUS_STT_DEVICE=cpu
HF_ENDPOINT=https://hf-mirror.com

---

2. Запуск админки

Админ-сервер поднимался в detached tmux-сессии, потому что фоновые процессы в bash-инструменте реапятся.

tmux kill-session -t nexusadmin 2>/dev/null; sleep 1
tmux new-session -d -s nexusadmin -c /home/user/moder/mcp/NexusAI \
  "export NEXUS_MEDIA_DIR=/tmp/opencode/nexus-media NEXUS_MASTER_KEY=fixed-test-master-key-1234567890 NEXUS_ADMIN_PORT=4123; exec node packages/admin/dist/server.js >/tmp/opencode/admin_live.log 2>&1"

Проверка:

HTTP:200
[2026-08-18T02:59:15.659Z] INFO (admin:api) routes registered
[2026-08-18T02:59:15.688Z] INFO (admin) NexusAI admin running at http://127.0.0.1:4123

---

3. Тест: веб-поиск «последние новости Барнаула»

Скрипт

Временный: packages/mcp-server/_search_test.cjs

Вызов

const { buildContext } = require('./dist/context.js');
const ctx = buildContext();
const p = ctx.registry.getSearch('nordrouter');
const res = await p.search({ query: 'последние новости Барнаула', recency: 'day', maxResults: 5 });

Статус

✅ Успех.

Сырой ответ ( answer )

Вот самые заметные новости Барнаула за последние сутки по доступным заголовкам и лентам:

- В Барнауле поддерживают подготовку к отопительному сезону...
- В городе идут дожди...
- В Барнауле можно бесплатно оформить медкарты...
- Показательные выступления служебных собак...
- На этой неделе в Барнауле можно сделать флюорографию...
- ...

Citations

1. https://brl.mk.ru/news/
2. https://ria.ru/location_Barnaul/
3. https://www.alt.kp.ru/
4. https://tolknews.ru/
5. https://barnaul.org/news/

Примечание

• Вызов был напрямую через адаптер, не через MCP-инструмент, поэтому в журнал не записался.
• costUsd вернулся undefined: NordRouter не возвращает usage.total_cost для perplexity/sonar-pro.

---

4. Тест: STT → TTS

4.1 Подготовка STT-модели

HuggingFace был недоступен (Broken pipe), поэтому модель faster-whisper-tiny скачана с зеркала ModelScope:

mkdir -p /tmp/opencode/whisper-tiny
cd /tmp/opencode/whisper-tiny
for f in config.json configuration.json model.bin tokenizer.json vocabulary.txt README.md; do
  curl -sL -o "$f" "https://modelscope.cn/models/systran/faster-whisper-tiny/resolve/master/$f"
done

4.2 Скрипты

• packages/mcp-server/_stt_test.cjs — прямой вызов local STT.
• packages/mcp-server/_tts_test.cjs — прямой вызов NordRouter TTS.

4.3 STT-результат

Файл: /home/user/Музыка/Денис/audio_2025-08-21_12-21-30.ogg (30K, Ogg)

--- text ---
А то с ука в 30 градусной жарее весь трещал передел свистелблять. Каких там только звуков не было под нагрузкой блять.

language: ru | duration: 7.76

4.4 TTS-результат

Модель: audio/gemini-3.1-flash-tts, голос Zephyr.

file_path: /tmp/opencode/nexus-media/audio-2026-08-18T03-25-00-156Z-v50yby.wav
mime_type: audio/wav
result_url: https://nordrouter.com/media/file/f987fdf8-5e2b-42c8-9883-6f18f8764452
cost_usd: 0.00825

4.5 Позже: полный цикл через MCP-инструменты

Использован Handlers.handle('nexus_stt', ...) и Handlers.handle('nexus_tts', ...). Записи появились в журнале и галерее.

Фикс: nexus_stt больше не сохраняет путь к исходному аудио как filePath, иначе галерея пытается отдать файл из /home/user/Музыка/... через /media/ и получает 404.

Коммит: c65f910.

---

5. Тест: генерация изображений (GPT Image 2, Seedream 5.0 Pro, Gemini 3.1 Flash)

Скрипты

• packages/mcp-server/_image_models.cjs — список image-моделей.
• packages/mcp-server/_image_gen.cjs — генерация тремя моделями.

Промпт

лисица кусает мухамор реалистичное фото изображение сделанное на проффисианальную камеру

Результаты

Модель	Статус	Файл	Стоимость
image/gpt-image-2	✅ done	/tmp/opencode/nexus-media/image-2026-08-18T04-04-28-304Z-izb5rj.png	$0
image/gemini-3.1-flash	✅ done	/tmp/opencode/nexus-media/image-2026-08-18T04-04-48-360Z-3gloqp.png	$0.011534
image/seedream-5.0-pro	❌ failed	—	средства не списаны

Ошибка Seedream

NexusError: Генерация временно недоступна — попробуйте ещё раз. Средства не списаны.

Повторный запрос дал тот же результат.

Сырой ответ (Gemini 3.1 Flash)

Изображение: лиса в зелёном лесу с красным мухомором во рту.

---

6. Тест: видео из картинки (Seedance 1.5 Pro)

Скрипты

• packages/mcp-server/_video_models.cjs
• packages/mcp-server/_video_gen.cjs

Параметры

• Модель: video/seedance-1.5-pro
• Входное изображение: https://nordrouter.com/media/file/4da49a3c-3866-44af-8e6c-d9360f5ebab8
• Промпт: A red fox gently bites and eats a bright red fly agaric mushroom...
• duration=5, aspect_ratio=16:9, resolution=720p, generate_audio=true

Результат

status: done
file_path: /tmp/opencode/nexus-media/video-2026-08-18T04-18-15-277Z-jb2tk9.mp4
mime_type: video/mp4
result_url: https://nordrouter.com/media/file/3dc0b9e7-5889-4f7b-b431-9087906380f9
cost_usd: 0.21875

Видео: 720p, 24 fps, AAC stereo — со звуком.

---

7. Тест: Kling 2.6 i2v с vision-описанием

7.1 Добавлен инструмент nexus_vision

Для полного цикла через NexusAI добавлен MCP-инструмент nexus_vision.

Изменения:

• packages/mcp-server/src/schemas.ts — VisionSchema
• packages/mcp-server/src/handlers.ts — обработчик vision
• packages/mcp-server/src/tools.ts — регистрация инструмента
• packages/core/src/shared/http.ts — поддержка FormData
• packages/core/src/providers/nordrouter/media.ts — определение MIME по расширению для upload

Дефолтная vision-модель: google/gemini-3.1-flash-lite.

7.2 Скрипты

• packages/mcp-server/_video_models.cjs
• packages/mcp-server/_vision_model_test.cjs — подбор рабочей vision-модели
• packages/mcp-server/_upload_image.cjs, _upload_debug.cjs, _upload_json.cjs, _upload_dataurl.cjs — отладка upload
• packages/mcp-server/_kling_test.cjs, _kling_retry.cjs, _kling_base64.cjs, _kling_neutral.cjs, _kling_standard.cjs, _kling26.cjs, _kling26_uploaded.cjs — тесты Kling

7.3 Подбор vision-модели

Начальные попытки (gpt-4o, openai/gpt-4o, gemini-3.1-flash) вернули unknown model. Список /v1/models показал, что у NordRouter модели вида google/gemini-3.1-flash-lite, openai/gpt-5.4-mini и т.д.

Рабочая: google/gemini-3.1-flash-lite.

7.4 Vision-описание (сырой ответ)

Вот подробное описание сцены, структурированное как профессиональный промпт для генерации видео:

### Видео-промпт: «Лиса и мухомор в осеннем лесу»

**Общая сцена и композиция:**
Кинематографичный кадр крупным планом, уровень глаз животного...

**Детали объектов:**
* Лиса: густая пушистая шерсть рыжего цвета...
* Гриб: классический мухомор...
* Окружение: лесная подстилка, мох, опавшие листья...

**Освещение и цвета:**
Мягкий естественный дневной свет...

**Технические параметры:**
Стиль фотоработы National Geographic, 8k, макро-фотография, гиперреализм...
Камера: f/2.8, объектив 85 мм...

7.5 Проблемы с Kling

Сначала Kling 2.1/2.6 возвращали:

Не удалось сгенерировать. Средства возвращены на баланс.

Причина: Kling i2v не принимал прямую ссылку на изображение, сгенерированное через /media/generate. Решение: загрузить исходник через nexus_media_upload и получить URL вида https://nordrouter.com/media/file/up-...?raw=1.

Также при upload был баг: MIME определялся как application/octet-stream, и NordRouter отвечал HTTP 415. Починено определением MIME по расширению файла.

7.6 Результат Kling 2.6 i2v

{
  "provider": "nordrouter",
  "capability": "video",
  "model": "video/kling-2.6-i2v",
  "status": "done",
  "file_path": "/tmp/opencode/nexus-media/video-2026-08-18T04-48-21-385Z-r5um7w.mp4",
  "mime_type": "video/mp4",
  "result_url": "https://nordrouter.com/media/file/3274f543-b954-4db5-9407-975cfa4de7cd",
  "cost_usd": 0.6875
}

• Длительность: 5.04 сек
• Разрешение: 1440×1440, 24 fps
• Аудио: AAC 44.1 kHz stereo
• Размер: 13M

---

8. Ошибки и фиксы

Проблема	Причина	Решение	Коммит
MCP падает без NEXUS_MASTER_KEY	KeyCipher пытался расшифровать пустой ключ	graceful fallback	6ff2b27
STT-запись даёт битую ссылку в галерее	filePath указывал на исходный аудиофайл	filePath = null для STT	c65f910
Upload возвращает 415	MIME не определялся по расширению	таблица mimeByExt	b2f57cc
Нет инструмента для vision	не было MCP-инструмента	добавлен nexus_vision	b2f57cc
Kling i2v не принимал сгенерированный URL	требует upload-URL ?raw=1	использован nexus_media_upload	—

---

9. Итоговая статистика

{
  "totalCostUsd": 0.950597,
  "totalCount": 18,
  "byProvider": [
    { "provider": "nordrouter", "count": 17, "costUsd": 0.950597 },
    { "provider": "local", "count": 1, "costUsd": 0 }
  ],
  "byCapability": [
    { "capability": "video", "count": 2, "costUsd": 0.90625 },
    { "capability": "tts", "count": 4, "costUsd": 0.022813 },
    { "capability": "image", "count": 4, "costUsd": 0.021534 },
    { "capability": "vision", "count": 1, "costUsd": 0 },
    { "capability": "stt", "count": 1, "costUsd": 0 }
  ],
  "byDay": [
    { "day": "2026-08-18", "count": 14, "costUsd": 0.931534 },
    { "day": "2026-08-17", "count": 4, "costUsd": 0.019063 }
  ]
}

---

10. Коммиты

b2f57cc feat(mcp-server): add nexus_vision tool and fix upload MIME detection
c65f910 fix(mcp-server): do not store source audio path as STT gallery file
1bc3746 Admin UX: light/dark theme, gallery pagination, content modal + delete, openai type
6ff2b27 Fix MCP crash when DB key exists without NEXUS_MASTER_KEY
679e564 Add admin web UI (Phase 2): spend dashboard, media gallery, provider management

---

11. Ключевые файлы

• /tmp/opencode/nexus-media/image-2026-08-18T04-04-48-360Z-3gloqp.png — Gemini 3.1 Flash (исходник для видео)
• /tmp/opencode/nexus-media/video-2026-08-18T04-18-15-277Z-jb2tk9.mp4 — Seedance 1.5 Pro i2v (со звуком)
• /tmp/opencode/nexus-media/video-2026-08-18T04-48-21-385Z-r5um7w.mp4 — Kling 2.6 i2v (со звуком)
• /tmp/opencode/whisper-tiny/ — локальная STT-модель
• /tmp/opencode/admin_live.log — лог админки

---

12. Выводы

• ✅ MCP-инструменты работают в полном цикле и пишут в журнал/галерею.
• ✅ Web search, STT, TTS, image, video, vision — все интегрированы.
• ✅ Поддержка конкретных моделей (model в запросе) работает.
• ⚠️ Некоторые модели временно недоступны (seedream-5.0-pro) или требуют upload (kling-2.6-i2v).
• ⚠️ Расходы на видео значительно выше оценок: Kling 2.6 i2v $0.6875 против estimated $0.3438.