MiniMax MCP

Máy chủ MiniMax Model Context Protocol (MCP) chính thức cho phép tương tác với các API Text to Speech và tạo video/hình ảnh mạnh mẽ. Máy chủ này cho phép các MCP client như Claude Desktop, Cursor, Windsurf, OpenAI Agents và các ứng dụng khác tạo giọng nói, nhân bản giọng nói, tạo video, tạo hình ảnh và hơn thế nữa.

💡 Đề xuất: MiniMax CLI (mmx-cli) — công cụ dòng lệnh chính thức của chúng tôi với các mô hình mới nhất và các tính năng bổ sung bao gồm văn bản, thị giác, tìm kiếm và cover nhạc. Hoạt động như một kỹ năng AI agent cho Claude Code, Cursor, OpenClaw, v.v.

Tài liệu

• 中文文档
• MiniMax-MCP-JS - Bản triển khai JavaScript chính thức của MiniMax MCP

Bắt đầu nhanh với MCP Client

1. Lấy API key của bạn từ MiniMax.
2. Cài đặt uv (trình quản lý gói Python), cài đặt bằng curl -LsSf https://astral.sh/uv/install.sh | sh hoặc xem uv repo để biết thêm các phương pháp cài đặt khác.
3. Quan trọng: API host và key thay đổi theo khu vực và phải khớp nhau; nếu không, bạn sẽ gặp lỗi Invalid API key.

Khu vực	Toàn cầu	Trung Quốc đại lục
MINIMAX_API_KEY	lấy từ MiniMax Global	lấy từ MiniMax
MINIMAX_API_HOST	https://api.minimax.io	https://api.minimaxi.com

Claude Desktop

Đi tới Claude > Settings > Developer > Edit Config > claude_desktop_config.json để thêm cấu hình sau:

{
  "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"
      }
    }
  }
}

⚠️ Cảnh báo: API key cần khớp với host. Nếu gặp lỗi "API Error: invalid api key", vui lòng kiểm tra api host của bạn:

• Host toàn cầu：https://api.minimax.io
• Host Trung Quốc đại lục：https://api.minimaxi.com

Nếu bạn đang dùng Windows, bạn cần bật "Developer Mode" trong Claude Desktop để sử dụng MCP server. Nhấp vào "Help" trong menu hamburger ở góc trên bên trái và chọn "Enable Developer Mode".

Cursor

Đi tới Cursor -> Preferences -> Cursor Settings -> MCP -> Add new global MCP Server để thêm cấu hình trên.

Vậy là xong. MCP client của bạn giờ có thể tương tác với MiniMax thông qua các công cụ sau:

Giao thức truyền tải

Chúng tôi hỗ trợ hai loại giao thức truyền tải: stdio và sse.

stdio	SSE
Chạy cục bộ	Có thể triển khai cục bộ hoặc trên đám mây
Giao tiếp qua stdout	Giao tiếp qua network
Đầu vào: Hỗ trợ xử lý local files hoặc tài nguyên URL hợp lệ	Đầu vào: Khi triển khai trên đám mây, nên sử dụng URL cho đầu vào

Các công cụ có sẵn

công cụ	mô tả
text_to_audio	Chuyển văn bản thành âm thanh với giọng đọc cho trước
list_voices	Liệt kê tất cả giọng đọc có sẵn
voice_clone	Nhân bản giọng nói bằng các tệp âm thanh được cung cấp
generate_video	Tạo video từ một prompt
text_to_image	Tạo hình ảnh từ một prompt
query_video_generation	Truy vấn kết quả của tác vụ tạo video
music_generation	Tạo bản nhạc từ prompt và lời bài hát
voice_design	Tạo giọng nói từ prompt bằng văn bản xem trước

Ghi chú phát hành

Ngày 2 tháng 7 năm 2025

🆕 Có gì mới

• Voice Design: Công cụ voice_design mới - tạo giọng nói tùy chỉnh từ các prompt mô tả kèm âm thanh xem trước
• Video Enhancement: Đã thêm mô hình MiniMax-Hailuo-02 với chất lượng siêu nét và các tùy chọn thời lượng/độ phân giải
• Music Generation: Nâng cấp công cụ music_generation được hỗ trợ bởi mô hình music-1.5

📈 Công cụ nâng cấp

• voice_design - Tạo giọng nói cá nhân hóa từ mô tả văn bản
• generate_video - Hiện hỗ trợ MiniMax-Hailuo-02 với thời lượng 6s/10s và tùy chọn độ phân giải 768P/1080P
• music_generation - Tạo nhạc chất lượng cao với mô hình music-1.5

Câu hỏi thường gặp

1. invalid api key

Vui lòng đảm bảo API key và API host của bạn khớp theo khu vực

Khu vực	Toàn cầu	Trung Quốc đại lục
MINIMAX_API_KEY	lấy từ MiniMax Global	lấy từ MiniMax
MINIMAX_API_HOST	https://api.minimax.io	https://api.minimaxi.com

2. spawn uvx ENOENT

Vui lòng xác nhận đường dẫn tuyệt đối của nó bằng cách chạy lệnh này trong terminal của bạn:

which uvx

Sau khi có được đường dẫn tuyệt đối (ví dụ: /usr/local/bin/uvx), hãy cập nhật cấu hình của bạn để sử dụng đường dẫn đó (ví dụ: "command": "/usr/local/bin/uvx").

3. Cách sử dụng generate_video ở chế độ async

Xác định các quy tắc hoàn thành trước khi bắt đầu: Ngoài ra, các quy tắc này có thể được cấu hình trong cài đặt IDE của bạn (ví dụ: Cursor):

Ví dụ sử dụng

⚠️ Cảnh báo: Sử dụng các công cụ này có thể phát sinh chi phí.

1. phát một đoạn tin tức buổi tối

2. nhân bản giọng nói

3. tạo video

4. tạo hình ảnh