Skip to main content
Glama

wesioiot-mcp

wesioiot 프록시(api.wesioiot.top)를 통해 라우팅되는 MiniMax 미디어(TTS, 이미지, 비디오, 음악)용 MCP 서버입니다.

사용 가능한 도구 (7)

Tool

기능

대략적 비용

text_to_audio

TTS (PT-BR 음성, hex 오디오)

$0.10 / 1k chars

list_voices

사용 가능한 PT-BR 음성 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은 MiniMax API를 중계하는 OpenAI 호환 프록시입니다. 클라이언트를 MiniMax의 직접 키(sk-cp-…) 대신 mmx-… 토큰으로 인증하며, 클라이언트별 rate-limit, 감사 로그, 할당량 제어를 지원합니다. 이 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 (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)       │
                                                            └──────────────────┘

프록시는 모든 호출을 감사하고, 키별 rate-limit을 적용하며, MiniMax 업스트림 API로 전달합니다. mmx-… 토큰은 프록시에 대해서만 유효합니다.

별도 MCP를 사용하는 이유

MiniMax의 공식 패키지 minimax-mcp는 개인 키 sk-cp-…를 사용해 api.minimax.io에 직접 연결합니다. 이 서버는:

  • 프록시 토큰(mmx-…)을 사용합니다 — 미디어가 채팅과 동일한 결제/감사 파이프라인을 거칩니다

  • voice_clone, voice_design, play_audio를 제거합니다(프록시에서 노출되지 않음)

  • 동일한 JSON-RPC / stdio 인터페이스를 유지하므로 모든 MCP 호환 클라이언트에서 작동합니다

두 MCP를 병렬로 실행할 수 있습니다: 음성 복제에는 minimax-mcp, 프록시로 청구되어야 하는 모든 작업에는 wesioiot-mcp를 사용하세요.

라이선스

MIT

Related MCP Connectors

Related MCP Servers