MiniMax MCP

官方

與MiniMax強大的文字轉語音、影像及影片生成API互動。

GitHub
1.6k
試用此 MCP贊助

你可以用 MiniMax MCP 做什麼？

  • 文字轉語音 — 請您的助理使用 text_to_audio 搭配所選聲音，將書面文字轉換為自然流暢的音訊。
  • 聲音克隆 — 提供範例音訊檔案給 voice_clone，即可用該克隆聲音生成語音。
  • 自訂聲音設計 — 以自然語言描述聲音，並使用 voice_design 建立含預覽音訊的自訂聲音。
  • 影片生成 — 透過 generate_video 從文字提示生成影片，並使用 query_video_generation 追蹤進度。
  • 圖片建立 — 使用 text_to_image 將文字提示轉換為圖片。
  • 聲音庫 — 使用 list_voices 瀏覽可用聲音，為您的專案挑選合適的聲音。

文件

export

官方 MiniMax 模型上下文協定（MCP）伺服器，可啟用與強大的文字轉語音及影片/圖片生成 API 進行互動。此伺服器允許 MCP 用戶端（如 Claude Desktop、Cursor、Windsurf、OpenAI Agents 等）生成語音、複製聲音、生成影片、生成圖片等。

💡 建議：MiniMax CLI (mmx-cli) — 我們的官方命令列工具，搭載最新模型與額外功能，包括文字、視覺與搜尋。可作為 Claude Code、Cursor、OpenClaw 等工具的 AI 代理技能使用。

文件

使用 MCP 用戶端快速開始

  1. 從 MiniMax 取得您的 API 金鑰。
  2. 安裝 uv（Python 套件管理工具），使用 curl -LsSf https://astral.sh/uv/install.sh | sh 安裝，或參閱 uv 儲存庫 以了解其他安裝方式。
  3. 重要：API 主機與金鑰會因地區而異，且必須相互匹配；否則您會遇到 Invalid API key 錯誤。
地區全球中國大陸
MINIMAX_API_KEY前往 MiniMax Global 取得前往 MiniMax 取得
MINIMAX_API_HOSThttps://api.minimax.iohttps://api.minimaxi.com

Claude Desktop

前往 Claude > Settings > Developer > Edit Config > claude_desktop_config.json 以加入以下內容：

{
  "mcpServers": {
    "MiniMax": {
      "command": "uvx",
      "args": [
        "minimax-mcp",
        "-y"
      ],
      "env": {
        "MINIMAX_API_KEY": "insert-your-api-key-here",
        "MINIMAX_MCP_BASE_PATH": "local-output-dir-path, such as /User/xxx/Desktop",
        "MINIMAX_API_HOST": "api host, https://api.minimax.io | https://api.minimaxi.com",
        "MINIMAX_API_RESOURCE_MODE": "optional, [url|local], url is default, audio/image/video are downloaded locally or provided in URL format"
      }
    }
  }
}

⚠️ 警告：API 金鑰必須與主機匹配。若出現「API Error: invalid api key」錯誤，請檢查您的 API 主機：

  • 全球主機：https://api.minimax.io
  • 中國大陸主機：https://api.minimaxi.com

如果您使用 Windows，您需要在 Claude Desktop 中啟用「開發者模式」才能使用 MCP 伺服器。點擊左上角漢堡選單中的「說明」，然後選擇「啟用開發者模式」。

Cursor

前往 Cursor -> Preferences -> Cursor Settings -> MCP -> Add new global MCP Server 以加入上述設定。

這樣就完成了。您的 MCP 用戶端現在可以透過這些工具與 MiniMax 互動：

傳輸方式

我們支援兩種傳輸類型：stdio 與 sse。

stdioSSE
在本機執行可部署於本機或雲端
透過 stdout 通訊透過 network 通訊
輸入：支援處理 local files 或有效的 URL 資源輸入：部署於雲端時，建議使用 URL 作為輸入

可用工具

工具說明
text_to_audio使用指定聲音將文字轉換為音訊
list_voices列出所有可用的聲音
voice_clone使用提供的音訊檔案複製聲音
generate_video根據提示詞生成影片
text_to_image根據提示詞生成圖片
query_video_generation查詢影片生成任務的結果
voice_design使用預覽文字根據提示詞生成聲音

版本說明

2025 年 7 月 2 日

🆕 新增功能

  • 聲音設計：新的 voice_design 工具 — 可從描述性提示詞建立自訂聲音，並附預覽音訊
  • 影片增強：新增 MiniMax-Hailuo-02 模型，具備超高畫質與時長/解析度控制功能

📈 增強工具

  • voice_design - 從文字描述生成個人化聲音
  • generate_video - 現在支援 MiniMax-Hailuo-02，提供 6 秒/10 秒時長與 768P/1080P 解析度選項

常見問題

1. invalid api key

請確保您的 API 金鑰與 API 主機在地區上相互對應

地區全球中國大陸
MINIMAX_API_KEY前往 MiniMax Global 取得前往 MiniMax 取得
MINIMAX_API_HOSThttps://api.minimax.iohttps://api.minimaxi.com

2. spawn uvx ENOENT

請在您的終端機中執行以下命令，以確認其絕對路徑：

which uvx

取得絕對路徑後（例如 /usr/local/bin/uvx），請更新您的設定以使用該路徑（例如「command」：「/usr/local/bin/uvx」）。

3. 如何在非同步模式中使用 generate_video

在開始前定義完成規則： 或者，這些規則可以在您的 IDE 設定中配置（例如 Cursor）：

使用範例

⚠️ 警告：使用這些工具可能會產生費用。

1. 播報一段晚間新聞

2. 複製聲音

3. 生成影片

4. 生成圖片