MiniMax MCP

ทางการ

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

GitHub
1.6k
ลองใช้ MCP นี้ผู้สนับสนุน

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

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

เอกสาร

export

เซิร์ฟเวอร์ Model Context Protocol (MCP) อย่างเป็นทางการของ MiniMax ที่เปิดใช้งานการโต้ตอบกับ API การแปลงข้อความเป็นเสียงพูด (Text to Speech) และการสร้างวิดีโอ/รูปภาพอันทรงพลัง เซิร์ฟเวอร์นี้ช่วยให้ไคลเอนต์ 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 หรือดู repo ของ 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 คุณจะต้องเปิดใช้งาน "Developer Mode" ใน Claude Desktop เพื่อใช้ MCP server คลิก "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สอบถามผลลัพธ์ของงานสร้างวิดีโอ
voice_designสร้างเสียงจากพรอมต์โดยใช้ข้อความตัวอย่าง

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

2 กรกฎาคม 2025

🆕 สิ่งใหม่

  • การออกแบบเสียง: เครื่องมือ voice_design ใหม่ - สร้างเสียงที่กำหนดเองจากพรอมต์เชิงพรรณนาพร้อมเสียงตัวอย่าง
  • การปรับปรุงวิดีโอ: เพิ่มโมเดล MiniMax-Hailuo-02 ด้วยคุณภาพระดับอัลตราเคลียร์และการควบคุมระยะเวลา/ความละเอียด

📈 เครื่องมือที่ปรับปรุง

  • voice_design - สร้างเสียงเฉพาะบุคคลจากคำอธิบายข้อความ
  • generate_video - ตอนนี้รองรับ MiniMax-Hailuo-02 ด้วยระยะเวลา 6 วินาที/10 วินาทีและตัวเลือกความละเอียด 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. วิธีใช้ generate_video ในโหมด async

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

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

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

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

2. โคลนเสียง

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

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