wesioiot-mcp

MCP server for MiniMax media (TTS, image, video, music) routed through the wesioiot proxy (api.wesioiot.top).

Available tools (7)

Related MCP server: mmxomni

What is the wesioiot proxy

api.wesioiot.top is an OpenAI-compatible proxy that fronts the MiniMax API. It authenticates clients with mmx-… tokens (instead of direct sk-cp-… keys from MiniMax), allowing per-client rate limiting, audit logging, and quota control. This MCP uses the proxy for all media calls, so the same token used in chat works here.

Installation

1. Install dependencies

npm install

Requires Node.js 20+.

2. Get a proxy token

You need an mmx-… key issued by the wesioiot proxy. If you run the proxy, create the key via the dashboard or directly 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. Configure the MCP

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 — Generic MCP client (stdio)

Configure your client to run:

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

With the environment variables:

4. Validate

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

Tool parameters

text_to_audio

• text (string, required) — text to synthesize

• voiceId (string) — voice ID (default: Portuguese_FascinatingBoy)

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

• speed (number 0.5–2.0) — speech speed

• vol (number 0.1–10.0) — volume

• pitch (number -12 to 12) — pitch shift

• outputDirectory (string) — where to save the MP3 (default: WESIOIOT_MCP_BASE_PATH)

text_to_image

• prompt (string, required) — image description

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

• n (number) — number of images (default 1)

• outputDirectory (string) — where to save

generate_video

• prompt (string, required) — video description

• Returns a taskId. Use query_video_generation to check.

music_generation

• lyrics (string, required) — song lyrics

• prompt (string) — style description

• title (string) — song title

• style (string) — musical style

• outputDirectory (string) — where to save

• Can return synchronously (direct audio) or asynchronously (task_id).

Available PT-BR voices

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

Architecture

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

The proxy audits each call, applies per-key rate limiting, and forwards to the upstream MiniMax API. The mmx-… token is only valid against the proxy.

Why a separate MCP

The official minimax-mcp package from MiniMax connects directly to api.minimax.io with a personal sk-cp-… key. This server:

• Uses your proxy token (mmx-…) – media goes through the same billing/audit pipeline as chat

• Removes voice_clone, voice_design, and play_audio (not exposed by the proxy)

• Maintains the same JSON-RPC / stdio interface, so any MCP-compatible client works

You can run both MCPs in parallel: minimax-mcp for voice cloning, wesioiot-mcp for everything that should be billed through the proxy.

License

GXP8