wesioiot-mcp

MCP-сервер для медиа MiniMax (TTS, изображение, видео, музыка), маршрутизируемый через прокси wesioiot (api.wesioiot.top).

Доступные инструменты (7)

Related MCP server: mmxomni

Что такое прокси wesioiot

api.wesioiot.top — это прокси, совместимый с OpenAI, который выступает перед API MiniMax. Он аутентифицирует клиентов с помощью токенов mmx-… (вместо прямых ключей sk-cp-… от MiniMax), позволяя ограничивать скорость для каждого клиента, вести журнал аудита и контролировать квоту. Этот MCP использует прокси для всех медиа-вызовов, поэтому тот же токен, который используется в чате, работает и здесь.

Установка

1. Установить зависимости

npm install

Требуется Node.js 20+.

2. Получить токен прокси

Вам нужен ключ mmx-…, выданный прокси wesioiot. Если вы запускаете прокси, создайте ключ через панель управления или напрямую в SQLite:

node -e "
const Database = require('better-sqlite3');
const db = new Database('/caminho/para/proxy/data/proxy.sqlite');
const k = db.prepare('SELECT key FROM api_keys WHERE label=?').get('seu-label');
console.log(k.key);
"

3. Настроить MCP

Вариант A — hermes mcp add (Hermes Agent)

printf "y\ny\n" | hermes mcp add wesioiot-mcp \
  --command node \
  --env WESIOIOT_API_KEY=mmx-... \
  --env WESIOIOT_API_HOST=https://api.wesioiot.top \
  --env WESIOIOT_MCP_BASE_PATH=/caminho/para/output \
  --args /caminho/absoluto/para/wesioiot-mcp/build/index.js

# Bug conhecido: o `hermes mcp add --env` só salva a última env var.
# Patchear as outras com:
hermes config set mcp_servers.wesioiot-mcp.env.WESIOIOT_API_KEY mmx-... --force
hermes config set mcp_servers.wesioiot-mcp.env.WESIOIOT_API_HOST https://api.wesioiot.top --force
hermes config set mcp_servers.wesioiot-mcp.enabled true --force

Вариант B — универсальный клиент MCP (stdio)

Настройте клиент на выполнение:

node /caminho/absoluto/para/wesioiot-mcp/build/index.js

С переменными окружения:

4. Проверить

hermes mcp test wesioiot-mcp
# Esperado: ✓ Connected (~20s) + 7 tools

Параметры инструментов

text_to_audio

• text (string, обязательно) — текст для синтеза

• voiceId (string) — ID голоса (по умолчанию: Portuguese_FascinatingBoy)

• model (string) — speech-02-hd, speech-02-turbo, speech-2.6-hd, speech-2.8-turbo

• speed (number 0.5–2.0) — скорость речи

• vol (number 0.1–10.0) — громкость

• pitch (number от -12 до 12) — сдвиг тона

• outputDirectory (string) — куда сохранить MP3 (по умолчанию: WESIOIOT_MCP_BASE_PATH)

text_to_image

• prompt (string, обязательно) — описание изображения

• aspectRatio (string) — 1:1, 16:9, 9:16 и т.д.

• n (number) — количество изображений (по умолчанию 1)

• outputDirectory (string) — куда сохранить

generate_video

• prompt (string, обязательно) — описание видео

• Возвращает taskId. Используйте query_video_generation для проверки.

music_generation

• lyrics (string, обязательно) — текст песни

• prompt (string) — описание музыкального стиля

• title (string) — название песни

• style (string) — музыкальный стиль

• outputDirectory (string) — куда сохранить

• Может возвращать синхронно (аудио напрямую) или асинхронно (task_id).

Доступные голоса PT-BR

Portuguese_FascinatingBoy          (padrão)
Portuguese_SmartYoungGirl
Portuguese_ConfidentWoman
Portuguese_Wiselady
Portuguese_Deep-VoicedGentleman
Portuguese_Jovialman
Portuguese_ThoughtfulMan
Portuguese_Strong-WilledBoy

Архитектура

┌──────────────┐   stdio    ┌──────────────────┐   HTTPS    ┌──────────────────┐
│  MCP client  │ ─────────▶ │  wesioiot-mcp    │ ─────────▶ │ api.wesioiot.top │
│  (Hermes AI) │   JSON-RPC │  (Node.js stdio) │   Bearer   │  (proxy)         │
└──────────────┘            └──────────────────┘   mmx-...   └────────┬─────────┘
                                                                      │ upstream
                                                                      ▼
                                                            ┌──────────────────┐
                                                            │  api.minimax.io  │
                                                            │  (MiniMax)       │
                                                            └──────────────────┘

Прокси аудирует каждый вызов, применяет ограничение скорости по ключу и передает запросы к вышестоящему API MiniMax. Токен mmx-… действителен только для прокси.

Зачем нужен отдельный MCP

Официальный пакет minimax-mcp от MiniMax подключается напрямую к api.minimax.io с личным ключом sk-cp-…. Этот сервер:

• Использует ваш токен прокси (mmx-…) — медиа проходит через тот же конвейер биллинга/аудита, что и чат

• Удаляет voice_clone, voice_design и play_audio (не предоставляемые прокси)

• Сохраняет тот же интерфейс JSON-RPC / stdio, поэтому работает любой MCP-совместимый клиент

Вы можете запускать оба MCP параллельно: minimax-mcp для клонирования голосов, wesioiot-mcp для всего, что должно оплачиваться через прокси.

Лицензия

MIT