MiniMax MCP
ทางการโต้ตอบกับ API อันทรงพลังของ MiniMax สำหรับ Text-to-Speech การสร้างรูปภาพ และวิดีโอ
คุณทำอะไรได้บ้างด้วย MiniMax MCP?
- แปลงข้อความเป็นเสียงพูด — ขอให้ผู้ช่วยแปลงข้อความที่เขียนเป็นเสียงโดยใช้เสียงที่ระบุ
- โคลนเสียง — โคลนเสียงจากไฟล์เสียงที่คุณให้มา แล้วนำไปใช้สร้างเสียงพูดได้อีก
- ออกแบบเสียง — สร้างเสียงแบบกำหนดเองจากพรอมป์ต์คำบรรยาย พร้อมเสียงตัวอย่าง
- สร้างและแก้ไขภาพ — สร้างภาพจากพรอมป์ต์ในพื้นที่ 1K/2K/4K หรือแก้ไขภาพโดยใช้พรอมป์ต์และภาพอ้างอิงได้สูงสุด 16 ภาพ
- สร้างวิดีโอ — สร้างวิดีโอจากพรอมป์ต์ พร้อมตัวเลือกระยะเวลาและความละเอียด และสอบถามผลลัพธ์ของงานภายหลังได้
เอกสาร

เซิร์ฟเวอร์ MiniMax Model Context Protocol (MCP) อย่างเป็นทางการ ซึ่งช่วยให้โต้ตอบกับ API สำหรับแปลงข้อความเป็นเสียงและสร้างวิดีโอ/รูปภาพอันทรงพลังได้ เซิร์ฟเวอร์นี้ช่วยให้ไคลเอ็นต์ MCP เช่น Claude Desktop, Cursor, Windsurf, OpenAI Agents และอื่น ๆ สามารถสร้างเสียง โคลนเสียง สร้างวิดีโอ สร้างรูปภาพ และทำสิ่งอื่น ๆ ได้
💡 แนะนำ: MiniMax CLI (mmx-cli) — เครื่องมือบรรทัดคำสั่งอย่างเป็นทางการของเราที่มาพร้อมโมเดลล่าสุดและฟีเจอร์เพิ่มเติม เช่น ข้อความ วิชัน และการค้นหา ใช้งานเป็นทักษะของเอเจนต์ AI สำหรับ Claude Code, Cursor, OpenClaw และอื่น ๆ ได้
เอกสารประกอบ
- เอกสารภาษาจีน
- MiniMax-MCP-JS - การติดตั้งใช้งาน MiniMax MCP อย่างเป็นทางการด้วย JavaScript
เริ่มต้นใช้งานอย่างรวดเร็วด้วยไคลเอ็นต์ MCP
- รับคีย์ API จาก MiniMax
- ติดตั้ง
uv(ตัวจัดการแพ็กเกจ Python) โดยติดตั้งด้วยcurl -LsSf https://astral.sh/uv/install.sh | shหรือดูuvrepo สำหรับวิธีติดตั้งเพิ่มเติม - สำคัญ: โฮสต์ 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 คุณต้องเปิดใช้งาน "Developer Mode" ใน Claude Desktop เพื่อใช้เซิร์ฟเวอร์ 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); ยังใช้ image-01 ได้ผ่าน model |
image_edit | แก้ไขรูปภาพด้วย MiniMax-H3-Image โดยใช้พรอมป์ต์และรูปภาพอ้างอิง 1-16 รูป |
query_video_generation | สอบถามผลลัพธ์ของงานสร้างวิดีโอ |
voice_design | สร้างเสียงจากพรอมป์ต์โดยใช้ข้อความตัวอย่าง |
บันทึกการเผยแพร่
10 พฤศจิกายน 2026
🆕 มีอะไรใหม่
- การแก้ไขรูปภาพ: เครื่องมือ
image_editใหม่ — แก้ไขรูปภาพด้วย MiniMax-H3-Image โดยใช้พรอมป์ต์และรูปภาพอ้างอิง 1-16 รูป (URL, data URI,mm_file://หรือพาธในเครื่อง) - การสร้างรูปภาพด้วย H3:
text_to_imageใช้ MiniMax-H3-Image เป็นค่าเริ่มต้น และรองรับarea(1K/2K/4K) และsize; ยังคงใช้image-01ได้ผ่านพารามิเตอร์model
📈 เครื่องมือที่ปรับปรุงแล้ว
text_to_image- ใช้ MiniMax-H3-Image (/v1/images/generations) เป็นค่าเริ่มต้น; ระบุmodel="image-01"เพื่อใช้โมเดลก่อนหน้า
2 กรกฎาคม 2025
🆕 มีอะไรใหม่
- การออกแบบเสียง: เครื่องมือ
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. วิธีใช้ generate_video ใน async-mode
กำหนดกฎการทำงานให้เสร็จก่อนเริ่มต้น:
หรือจะกำหนดค่ากฎเหล่านี้ในการตั้งค่า IDE (เช่น Cursor) ก็ได้:

ตัวอย่างการใช้งาน
⚠️ คำเตือน: การใช้เครื่องมือเหล่านี้อาจมีค่าใช้จ่าย
1. อ่านข่าวภาคค่ำช่วงหนึ่ง
2. โคลนเสียง
3. สร้างวิดีโอ
4. สร้างรูปภาพ
