wesioiot-mcp

Servidor MCP para medios MiniMax (TTS, imagen, vídeo, música) enrutado a través del proxy wesioiot (api.wesioiot.top).

Herramientas disponibles (7)

Related MCP server: mmxomni

Qué es el proxy wesioiot

api.wesioiot.top es un proxy compatible con OpenAI que se sitúa frente a la API de MiniMax. Autentica clientes con tokens mmx-… (en lugar de las claves directas sk-cp-… de MiniMax), permitiendo rate-limit por cliente, registro de auditoría y control de cuota. Este MCP utiliza el proxy para todas las llamadas de medios, por lo que el mismo token que usa el chat funciona aquí.

Instalación

1. Instalar dependencias

npm install

Requiere Node.js 20+.

2. Obtener un token del proxy

Necesitas una clave mmx-… emitida por el proxy wesioiot. Si ejecutas el proxy, crea la clave desde el panel o directamente en 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. Configurar el MCP

Opción 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

Opción B — Cliente MCP genérico (stdio)

Configura tu cliente para ejecutar:

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

Con las variables de entorno:

4. Validar

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

Parámetros de las herramientas

text_to_audio

• text (cadena, obligatorio) — texto a sintetizar

• voiceId (cadena) — ID de la voz (por defecto: Portuguese_FascinatingBoy)

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

• speed (número 0.5–2.0) — velocidad del habla

• vol (número 0.1–10.0) — volumen

• pitch (número -12 a 12) — desplazamiento de tono

• outputDirectory (cadena) — dónde guardar el MP3 (por defecto: WESIOIOT_MCP_BASE_PATH)

text_to_image

• prompt (cadena, obligatorio) — descripción de la imagen

• aspectRatio (cadena) — 1:1, 16:9, 9:16, etc.

• n (número) — cantidad de imágenes (por defecto 1)

• outputDirectory (cadena) — dónde guardar

generate_video

• prompt (cadena, obligatorio) — descripción del vídeo

• Devuelve un taskId. Usa query_video_generation para verificar.

music_generation

• lyrics (cadena, obligatorio) — letra de la música

• prompt (cadena) — descripción del estilo musical

• title (cadena) — título de la música

• style (cadena) — estilo musical

• outputDirectory (cadena) — dónde guardar

• Puede devolver sincrónicamente (audio directo) o asincrónicamente (task_id).

Voces PT-BR disponibles

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

Arquitectura

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

El proxy audita cada llamada, aplica rate-limit por clave y reenvía a la API upstream de MiniMax. El token mmx-… solo es válido contra el proxy.

Por qué un MCP separado

El paquete oficial minimax-mcp de MiniMax conecta directamente a api.minimax.io con clave personal sk-cp-…. Este servidor:

• Usa tu token del proxy (mmx-…) — los medios pasan por el mismo pipeline de facturación/auditoría que el chat

• Elimina voice_clone, voice_design y play_audio (no expuestos por el proxy)

• Mantiene la misma interfaz JSON-RPC / stdio, por lo que cualquier cliente compatible con MCP funciona

Puedes ejecutar ambos MCPs en paralelo: minimax-mcp para clonar voces, wesioiot-mcp para todo lo que se debe cobrar del proxy.

Licencia

MIT