Skip to main content
Glama

wesioiot-mcp

用于MiniMax媒体(TTS、图像、视频、音乐)的MCP服务器,通过wesioiot代理(api.wesioiot.top)路由。

可用工具(7个)

工具

功能

大致费用

text_to_audio

TTS(巴葡语音,十六进制音频)

每千字符 $0.10

list_voices

列出8种可用巴葡语音

免费

text_to_image

图像生成(image-01)

每张图像 $0.02

generate_video

视频生成(Hailuo 2.3,异步)

每个视频 $0.20–0.50

query_video_generation

轮询视频任务

免费

music_generation

音乐生成(music-2.6,同步/异步)

每首音乐 $0.10

query_music_generation

轮询音乐任务

免费

Related MCP server: mmxomni

什么是wesioiot代理

api.wesioiot.top 是一个兼容OpenAI的代理,作为MiniMax API的前端。它使用 mmx-… 令牌(而非MiniMax的直接密钥 sk-cp-…)对客户端进行身份验证,从而实现按客户端的限速、审计日志和配额控制。此MCP通过该代理进行所有媒体调用,因此聊天使用的令牌在此同样有效。

安装

1. 安装依赖

npm install

需要 Node.js 20+。

2. 获取代理令牌

您需要一个由wesioiot代理颁发的 mmx-… 密钥。如果您运行代理,可以通过仪表盘或直接在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

使用以下环境变量:

变量

必填

默认值

示例

WESIOIOT_API_KEY

✅

—

mmx-3dc90e8e...

WESIOIOT_API_HOST

❌

https://api.wesioiot.top

自定义代理URL

WESIOIOT_MCP_BASE_PATH

❌

/tmp

~/.cache/wesioiot-mcp

4. 验证

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

工具参数

text_to_audio

  • text(字符串,必填)— 要合成的文本

  • voiceId(字符串)— 语音ID(默认:Portuguese_FascinatingBoy)

  • model(字符串)— speech-02-hd、speech-02-turbo、speech-2.6-hd、speech-2.8-turbo

  • speed(数字 0.5–2.0)— 语速

  • vol(数字 0.1–10.0)— 音量

  • pitch(数字 -12 到 12)— 音调偏移

  • outputDirectory(字符串)— 保存MP3的位置(默认:WESIOIOT_MCP_BASE_PATH)

text_to_image

  • prompt(字符串,必填)— 图像描述

  • aspectRatio(字符串)— 1:1、16:9、9:16 等。

  • n(数字)— 图像数量(默认1)

  • outputDirectory(字符串)— 保存位置

generate_video

  • prompt(字符串,必填)— 视频描述

  • 返回一个 taskId。使用 query_video_generation 进行检查。

music_generation

  • lyrics(字符串,必填)— 歌词

  • prompt(字符串)— 音乐风格描述

  • title(字符串)— 歌曲标题

  • style(字符串)— 音乐风格

  • outputDirectory(字符串)— 保存位置

  • 可能同步返回(直接音频)或异步返回(task_id)。

可用的巴葡语音

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)       │
                                                            └──────────────────┘

代理审计每次调用,按密钥应用限速,并转发到上游MiniMax API。mmx-… 令牌仅对代理有效。

为什么需要单独的MCP

MiniMax官方包 minimax-mcp 直接连接到 api.minimax.io,使用个人密钥 sk-cp-…。此服务器:

  • 使用您的代理令牌(mmx-…)— 媒体通过相同的计费/审计通道处理

  • 移除了 voice_clone、voice_design 和 play_audio(未通过代理暴露)

  • 保持相同的 JSON-RPC / stdio 接口,因此任何兼容MCP的客户端均可工作

您可以并行运行两个MCP:minimax-mcp 用于克隆语音,wesioiot-mcp 用于所有需通过代理计费的操作。

许可证

MIT

Related MCP Connectors

Related MCP Servers