MiniMax MCP

ทางการ

โต้ตอบกับ API การสร้างข้อความเป็นเสียง รูปภาพ และวิดีโออันทรงพลังของ MiniMax

GitHub
1.5k

คุณทำอะไรได้บ้างด้วย Mini Max MCP?

  • แปลงข้อความเป็นคำพูด — ขอให้ผู้ช่วยของคุณสร้างเสียงพูดจากข้อความใดๆ โดยใช้ text_to_audio พร้อมเลือกเสียงที่ต้องการ
  • โคลนเสียงจากตัวอย่าง — จัดเตรียมไฟล์เสียงและใช้ voice_clone เพื่อสร้างเสียงที่กำหนดเองซึ่งเลียนแบบผู้พูดต้นฉบับ
  • ออกแบบเสียงจากคำอธิบาย — อธิบายคุณภาพเสียงที่ต้องการและใช้ voice_design เพื่อสร้างตัวอย่างเสียงที่กำหนดเองนั้น
  • สร้างภาพจากคำบรรยาย — สร้างภาพโดยอธิบายสิ่งที่คุณต้องการด้วย text_to_image
  • สร้างวิดีโอจากคำบรรยาย — สร้างคลิปวิดีโอโดยอธิบายฉาก พร้อมตัวเลือกควบคุมระยะเวลาและความละเอียดผ่าน generate_video
  • สร้างเพลงจากคำบรรยายและเนื้อร้อง — แต่งเพลงโดยระบุคำบรรยายสไตล์และเนื้อร้องให้กับ music_generation

เอกสาร

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

  1. รับคีย์ API ของคุณจาก MiniMax
  2. ติดตั้ง uv (ตัวจัดการแพ็คเกจ Python) ติดตั้งด้วย curl -LsSf https://astral.sh/uv/install.sh | sh หรือดู uv repo สำหรับวิธีการติดตั้งเพิ่มเติม
  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 คลิก "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สร้างรูปภาพจากพรอมต์
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 ของคุณสอดคล้องกันตามภูมิภาค

ภูมิภาคทั่วโลกจีนแผ่นดินใหญ่
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. สร้างรูปภาพ