MiniMax MCP

官方

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

你可以用 MiniMax MCP 做什麼?

  • 文字轉語音 — 請助理使用指定的聲音將文字轉換成音訊。
  • 聲音複製 — 從你提供的音訊檔案複製聲音,然後將其用於語音生成。
  • 聲音設計 — 根據描述性提示生成自訂聲音,並提供預覽音訊。
  • 圖像生成與編輯 — 根據提示建立 1K/2K/4K 區域的圖像,或使用提示和最多 16 張參考圖像編輯圖像。
  • 影片生成 — 根據提示生成影片,提供時長和解析度選項,並可在之後查詢任務結果。

文件

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 中啟用「Developer Mode」才能使用 MCP 伺服器。點選左上角漢堡選單中的「Help」,然後選取「Enable Developer Mode」。

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根據提示生成圖片。預設使用 MiniMax-H3-Image(支援 area 1K/2K/4K 和 size);仍可透過 model 使用 image-01
image_edit使用提示和 1-16 張參考圖片,透過 MiniMax-H3-Image 編輯圖片
query_video_generation查詢影片生成任務的結果
voice_design根據提示和預覽文字生成聲音

版本資訊

2026 年 11 月 10 日

🆕 新功能

  • 圖片編輯:新增 image_edit 工具 — 使用提示和 1-16 張參考圖片(URL、資料 URI、mm_file:// 或本機路徑),透過 MiniMax-H3-Image 編輯圖片
  • H3 圖片生成:text_to_image 現在預設使用 MiniMax-H3-Image,並支援 area(1K/2K/4K)和 size;仍可透過 model 參數使用 image-01

📈 工具強化

  • text_to_image - 預設使用 MiniMax-H3-Image(/v1/images/generations);傳入 model="image-01" 可使用先前的模型

2025 年 7 月 2 日

🆕 新功能

  • 聲音設計:新增 voice_design 工具 - 根據描述性提示建立自訂聲音,並提供預覽音訊
  • 影片強化:新增 MiniMax-Hailuo-02 模型,提供超清晰畫質以及時長/解析度控制

📈 工具強化

  • voice_design - 根據文字描述生成個人化聲音
  • generate_video - 現在支援 MiniMax-Hailuo-02,提供 6s/10s 時長及 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. 如何在 async-mode 中使用 generate_video

開始前先定義完成規則: 或者,也可以在 IDE 設定中設定這些規則(例如 Cursor):

使用範例

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

1. 播報一段晚間新聞

2. 複製聲音

3. 生成影片

4. 生成圖片