/ 目錄 / 演練場 / MiniMax-MCP
● 社群 MiniMax-AI ⚡ 即開即用

MiniMax-MCP

作者 MiniMax-AI · MiniMax-AI/MiniMax-MCP

官方 MiniMax MCP — 文字轉語音、語音克隆、文字轉圖像、文字轉影片和音樂生成,全部從聊天完成。

MiniMax-AI/MiniMax-MCP 是 MiniMax 官方的 MCP,封裝了他們的 TTS、語音設計、圖像、影片和音樂 API。地區特定:全球版(api.minimax.io)和中國大陸版(api.minimaxi.com)有不同的金鑰。

為什麼要用

核心特性

即時演示

實際使用效果

minimax.replay ▶ 就緒
0/0

安裝

選擇你的客戶端

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "minimax": {
      "command": "uvx",
      "args": [
        "MiniMax-MCP"
      ],
      "_inferred": true
    }
  }
}

開啟 Claude Desktop → Settings → Developer → Edit Config。儲存後重啟應用。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "minimax": {
      "command": "uvx",
      "args": [
        "MiniMax-MCP"
      ],
      "_inferred": true
    }
  }
}

Cursor 使用與 Claude Desktop 相同的 mcpServers 格式。專案級設定優先於全域。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "minimax": {
      "command": "uvx",
      "args": [
        "MiniMax-MCP"
      ],
      "_inferred": true
    }
  }
}

點擊 Cline 側欄中的 MCP Servers 圖示,然後選 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "minimax": {
      "command": "uvx",
      "args": [
        "MiniMax-MCP"
      ],
      "_inferred": true
    }
  }
}

格式與 Claude Desktop 相同。重啟 Windsurf 生效。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "minimax",
      "command": "uvx",
      "args": [
        "MiniMax-MCP"
      ]
    }
  ]
}

Continue 使用伺服器物件陣列,而非映射。

~/.config/zed/settings.json
{
  "context_servers": {
    "minimax": {
      "command": {
        "path": "uvx",
        "args": [
          "MiniMax-MCP"
        ]
      }
    }
  }
}

加入 context_servers。Zed 儲存後熱重載。

claude mcp add minimax -- uvx MiniMax-MCP

一行命令搞定。用 claude mcp list 驗證,claude mcp remove 移除。

使用場景

實戰用法: MiniMax-MCP

如何將部落格文章轉換為敘述音訊

👤 內容創作者、Podcast 製作人、無障礙團隊 ⏱ ~15 min beginner

何時使用: 你想要將書面內容轉換成可聽的版本。

前置條件
  • MiniMax 帳戶 + API 金鑰 — 全球版:minimax.io;中國大陸版:minimaxi.com。設定 MINIMAX_API_KEY + MINIMAX_API_HOST 符合地區
  • 已安裝 uvx — brew install uv
步驟
  1. 列出語音
    list_voices — 顯示所有可用的英文語音。✓ 已複製
    → 語音目錄,含預覽
  2. 生成音訊
    text_to_audio: [貼上文章] 使用語音 'female-calm-en'。存到 /audio/article.mp3。✓ 已複製
    → MP3 檔案已存,回傳網址

結果: 你內容的可聽版本。

注意事項
  • 長文章超過單次呼叫的字元限制 — 分段落拆分,分別生成,再合併
  • 專有名詞的發音不對 — 使用 SSML 式的音標提示或用 voice_design 工具建立特化語音
搭配使用: filesystem

如何克隆你自己的語音進行敘述

👤 想要一致敘述者的內容創作者 ⏱ ~10 min intermediate

何時使用: 你想要用自己的聲音進行 AI 敘述。

前置條件
  • 10-60 秒的語音樣本(乾淨音訊,你的聲音) — 用手機錄音;匯出為 mp3/wav 格式
步驟
  1. 克隆
    voice_clone 使用樣本 /recordings/me.wav,名稱 'my-voice'。✓ 已複製
    → 回傳語音 id
  2. 使用
    text_to_audio 使用 voice='my-voice' 對 [貼上文字]。✓ 已複製
    → 用你的聲音輸出

結果: 每次都能有個人的敘述,不用每次錄音。

注意事項
  • 未經同意使用他人的聲音 — 別這樣做 — 有法律和倫理問題;改用 voice_design

如何生成圖像並將其轉換為短影片

👤 內容創作者、行銷人員 ⏱ ~15 min intermediate

何時使用: 社群內容、產品預覽。

步驟
  1. 生成圖像
    text_to_image: '陶製馬克杯的簡潔工作室產品照,自然光'。✓ 已複製
    → 圖像網址
  2. 動畫化
    generate_video 使用 prompt '木製桌上的馬克杯緩慢旋轉'。用 query_video_generation 輪詢狀態。✓ 已複製
    → 準備好時的影片網址

結果: 短行銷影片。

注意事項
  • 影片生成是非同步的,可能花幾分鐘 — 總是用 query_video_generation 輪詢 — 別讓聊天一直等待
搭配使用: google-workspace

組合

與其他 MCP 搭配,撬動十倍槓桿

minimax + filesystem

將生成的素材存到結構化內容資料夾

為 /manuscript/ 中的每一章生成敘述,並將 MP3 存到 /audio/chapters/。✓ 已複製

從 Google 文件產生音訊,然後在文件中附加連結

讀取文件 'Launch Post',生成敘述,上傳到 Drive,在頁尾附加連結。✓ 已複製

工具

此 MCP 暴露的能力

工具輸入參數何時呼叫成本
text_to_audio text: str, voice: str, format?: 'mp3'|'wav', output_path? 敘述文字 Per MiniMax TTS pricing
list_voices language?: str 尋找語音 free
voice_clone sample_path: str, name: str 自訂語音 Per MiniMax pricing
voice_design description: str 從散文生成語音 Per MiniMax pricing
text_to_image prompt: str, aspect_ratio? 圖像生成 Per MiniMax image pricing
generate_video prompt: str, duration_s? 啟動影片生成 Per MiniMax video pricing
query_video_generation task_id 輪詢影片工作 free
music_generation lyrics: str, genre?: str 建立短曲 Per MiniMax music pricing

成本與限制

運行它的成本

API 配額
依 MiniMax 方案而定 — 檢查 minimax.io 或 minimaxi.com 的目前定價
每次呼叫 Token 數
適量的文字輸入;輸出為音訊/圖像/影片檔案
費用
按次付費;以 Flash/Hailuo-Mini 等效版本開始最便宜
提示
盡可能將短的文字轉語音批次處理為更少更長的呼叫;影片最昂貴 — 快取結果。

安全

權限、密鑰、影響範圍

最小權限: MINIMAX_API_KEY + MINIMAX_API_HOST 符合地區
憑證儲存: 環境變數
資料出站: 你的文字/音訊會發送到所選地區的 MiniMax 伺服器
切勿授予: 不要混用全球版和中國大陸版的金鑰 — 會導致 'Invalid API key'

故障排查

常見錯誤與修復

API 金鑰無效

金鑰和主機地區必須相符。全球版設定 MINIMAX_API_HOST=https://api.minimax.io,中國大陸版設定 https://api.minimaxi.com。

驗證: env | grep MINIMAX
影片生成永遠不完成

用 query_video_generation 輪詢最多 10 分鐘;超過預期時間通常表示伺服器負載。如果卡住,用新工作重試。

voice_clone 品質不佳

樣本音訊必須 10-60 秒,乾淨(無音樂/雜音),單一說話者。

超過速率限制

MiniMax 強制每分鐘和每天上限。退避;升級方案以獲得更高限制。

替代方案

MiniMax-MCP 對比其他方案

替代方案何時用它替代權衡
ElevenLabs MCP你想要針對西方市場的文字轉語音,具有專屬英��語音沒有影片/圖像/音樂的一體套件
OpenAI/Whisper for TTS你已經有 OpenAI 額度語音選項比 MiniMax 少

更多

資源

📖 閱讀 GitHub 上的官方 README

🐙 查看未解決的 issue

🔍 瀏覽全部 400+ MCP 伺服器和 Skills