MiniMax MCP

官方

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

GitHub
1.6k
試用此 MCP贊助

你可以用 MiniMax MCP 做什麼？

  • 文字轉語音 — 透過 text_to_audio 搭配所選語音，將任何文字轉換為自然流暢的音訊。
  • 語音克隆 — 透過 voice_clone 從範例音訊檔案建立自訂語音，用於個人化旁白。
  • 影片生成 — 使用 generate_video 將文字提示轉換為影片，並可透過 query_video_generation 查詢進度。
  • 影像建立 — 使用 text_to_image 從描述性提示產生影像。
  • 音樂創作 — 使用 music_generation 從歌詞和提示創作原創音樂曲目。
  • 語音設計 — 使用 voice_design 從文字描述打造獨特語音，並可透過範例音訊預覽。

文件

export

官方 MiniMax Model Context Protocol (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查詢影片生成任務的結果
music_generation根據提示詞和歌詞生成音樂曲目
voice_design使用預覽文字根據提示詞生成聲音

版本說明

2025 年 7 月 2 日

🆕 新增功能

  • 聲音設計：新增 voice_design 工具 - 可從描述性提示詞建立自訂聲音，並附預覽音訊
  • 影片增強：新增 MiniMax-Hailuo-02 模型，具備超高畫質及時長/解析度控制
  • 音樂生成：增強 music_generation 工具，由 music-1.5 模型驅動

📈 增強工具

  • voice_design - 從文字描述生成個人化聲音
  • generate_video - 現在支援 MiniMax-Hailuo-02，提供 6 秒/10 秒時長及 768P/1080P 解析度選項
  • music_generation - 使用 music-1.5 模型進行高品質音樂創作

常見問題

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. 生成圖片