MiniMax MCP

ทางการ

โต้ตอบกับ API อันทรงพลังของ MiniMax สำหรับ Text-to-Speech การสร้างรูปภาพ และวิดีโอ

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) — เครื่องมือบรรทัดคำสั่งอย่างเป็นทางการของเราพร้อมโมเดลล่าสุดและฟีเจอร์เพิ่มเติม รวมถึงข้อความ วิสัยทัศน์ การค้นหา และการคัฟเวอร์เพลง ทำงานเป็นทักษะตัวแทน AI สำหรับ Claude Code, Cursor, OpenClaw และอื่นๆ

เอกสารประกอบ

  • 中文文档
  • MiniMax-MCP-JS - การใช้งาน JavaScript อย่างเป็นทางการของ MiniMax MCP

เริ่มต้นใช้งานอย่างรวดเร็วกับ MCP Client

  1. รับคีย์ API ของคุณจาก MiniMax
  2. ติดตั้ง uv (ตัวจัดการแพ็กเกจ Python) ติดตั้งด้วย curl -LsSf https://astral.sh/uv/install.sh | sh หรือดู uv repo สำหรับวิธีการติดตั้งเพิ่มเติม
  3. สำคัญ: โฮสต์ API และคีย์จะแตกต่างกันตามภูมิภาคและต้องตรงกัน มิฉะนั้นคุณจะพบข้อผิดพลาด Invalid API key
ภูมิภาคทั่วโลกจีนแผ่นดินใหญ่
MINIMAP_API_KEYรับได้จาก MiniMax Globalรับได้จาก MiniMax
MINIMAP_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 คุณจะต้องเปิดใช้งาน "Developer Mode" ใน Claude Desktop เพื่อใช้เซิร์ฟเวอร์ MCP คลิก "Help" ในเมนูแฮมเบอร์เกอร์ที่มุมซ้ายบนและเลือก "Enable Developer Mode"

Cursor

ไปที่ Cursor -> Preferences -> Cursor Settings -> MCP -> Add new global MCP Server เพื่อเพิ่มการกำหนดค่าด้านบน

เสร็จแล้ว ไคลเอนต์ MCP ของคุณสามารถโต้ตอบกับ MiniMax ผ่านเครื่องมือเหล่านี้ได้:

การขนส่ง (Transport)

เรารองรับการขนส่งสองประเภท: 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สร้างเสียงจากพรอมต์โดยใช้ข้อความตัวอย่าง

บันทึกการเผยแพร่

2 กรกฎาคม 2025

🆕 สิ่งใหม่

  • การออกแบบเสียง: เครื่องมือ 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 ของคุณสอดคล้องกันตามภูมิภาค

ภูมิภาคทั่วโลกจีนแผ่นดินใหญ่
MINIMAP_API_KEYรับได้จาก MiniMax Globalรับได้จาก MiniMax
MINIMAP_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 ในโหมด async

กำหนดกฎการเสร็จสิ้นก่อนเริ่มต้น: หรือสามารถกำหนดกฎเหล่านี้ได้ในการตั้งค่า IDE ของคุณ (เช่น Cursor):

ตัวอย่างการใช้งาน

⚠️ คำเตือน: การใช้เครื่องมือเหล่านี้อาจมีค่าใช้จ่าย

1. ออกอากาศข่าวภาคค่ำบางส่วน

2. โคลนเสียง

3. สร้างวิดีโอ

4. สร้างรูปภาพ