wesioiot-mcp

MCP-Server für MiniMax-Medien (TTS, Bild, Video, Musik), geroutet über den Proxy wesioiot (api.wesioiot.top).

Verfügbare Tools (7)

Related MCP server: mmxomni

Was ist der Proxy wesioiot

api.wesioiot.top ist ein OpenAI-kompatibler Proxy, der als Frontend zur MiniMax-API dient. Er authentifiziert Clients mit Tokens vom Typ mmx-… (anstelle der direkten MiniMax-Schlüssel sk-cp-…) und ermöglicht so Ratenbegrenzung pro Client, Audit-Logging und Kontingentsteuerung. Dieser MCP nutzt den Proxy für alle Medienaufrufe, sodass derselbe Token, den der Chat verwendet, auch hier funktioniert.

Installation

1. Abhängigkeiten installieren

npm install

Erfordert Node.js 20+.

2. Einen Proxy-Token abrufen

Sie benötigen einen vom Proxy wesioiot ausgestellten mmx-…-Schlüssel. Wenn Sie den Proxy betreiben, erstellen Sie den Schlüssel über das Dashboard oder direkt in 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 konfigurieren

Option 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

Option B — Generischer MCP-Client (stdio)

Konfigurieren Sie Ihren Client zur Ausführung von:

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

Mit den Umgebungsvariablen:

4. Validieren

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

Parameter der Tools

text_to_audio

• text (string, erforderlich) — zu synthetisierender Text

• voiceId (string) — ID der Stimme (Standard: Portuguese_FascinatingBoy)

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

• speed (number 0.5–2.0) — Sprechgeschwindigkeit

• vol (number 0.1–10.0) — Lautstärke

• pitch (number -12 bis 12) — Tonhöhenverschiebung

• outputDirectory (string) — Speicherort für die MP3-Datei (Standard: WESIOIOT_MCP_BASE_PATH)

text_to_image

• prompt (string, erforderlich) — Beschreibung des Bildes

• aspectRatio (string) — 1:1, 16:9, 9:16, usw.

• n (number) — Anzahl der Bilder (Standard 1)

• outputDirectory (string) — Speicherort

generate_video

• prompt (string, erforderlich) — Beschreibung des Videos

• Gibt eine taskId zurück. Verwenden Sie query_video_generation zur Überprüfung.

music_generation

• lyrics (string, erforderlich) — Liedtext

• prompt (string) — Beschreibung des Musikstils

• title (string) — Titel des Musikstücks

• style (string) — Musikrichtung

• outputDirectory (string) — Speicherort

• Kann synchron (direktes Audio) oder asynchron (task_id) zurückgegeben werden.

Verfügbare PT-BR-Stimmen

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

Architektur

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

Der Proxy prüft jeden Aufruf, wendet Ratenbegrenzung pro Schlüssel an und leitet an die vorgelagerte MiniMax-API weiter. Der Token mmx-… ist nur gegen den Proxy gültig.

Warum ein separater MCP

Das offizielle Paket minimax-mcp von MiniMax verbindet direkt mit api.minimax.io mit persönlichem Schlüssel sk-cp-…. Dieser Server:

• Verwendet Ihren Proxy-Token (mmx-…) — Medien durchlaufen dieselbe Abrechnungs-/Prüfpipeline wie der Chat

• Entfernt voice_clone, voice_design und play_audio (vom Proxy nicht verfügbar gemacht)

• Behält dieselbe JSON-RPC-/stdio-Schnittstelle bei, sodass jeder MCP-kompatible Client funktioniert

Sie können beide MCPs parallel ausführen: minimax-mcp zum Klonen von Stimmen, wesioiot-mcp für alles, was über den Proxy abgerechnet werden soll.

Lizenz

MIT