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

官方 MiniMax Model Context Protocol (MCP) 伺服器,可與強大的文字轉語音及影片/圖片生成 API 互動。此伺服器可讓 MCP 用戶端(例如 Claude Desktop、Cursor、Windsurf、OpenAI Agents 等)生成語音、複製聲音、生成影片、生成圖片等。
💡 建議使用:MiniMax CLI (mmx-cli) — 我們的官方命令列工具,提供最新模型及文字、視覺和搜尋等額外功能。可作為 Claude Code、Cursor、OpenClaw 等工具的 AI 代理技能使用。
文件
- 中文文檔
- MiniMax-MCP-JS - MiniMax MCP 的官方 JavaScript 實作
使用 MCP 用戶端快速入門
- 從 MiniMax 取得 API 金鑰。
- 安裝
uv(Python 套件管理工具),使用curl -LsSf https://astral.sh/uv/install.sh | sh安裝,或參閱uv儲存庫 了解其他安裝方式。 - 重要:API 主機和金鑰會因地區而異,兩者必須相符,否則會遇到
Invalid API key錯誤。
| 地區 | 全球 | 中國大陸 |
|---|---|---|
| MINIMAX_API_KEY | 從 MiniMax Global 取得 | 從 MiniMax 取得 |
| MINIMAX_API_HOST | https://api.minimax.io | https://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。
| stdio | SSE |
|---|---|
| 在本機執行 | 可在本機或雲端部署 |
透過 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_HOST | https://api.minimax.io | https://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. 生成圖片
