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 chuyển văn bản thành giọng nói (Text to Speech) và tạo video/hình ảnh mạnh mẽ. Máy chủ này cho phép các máy khách MCP 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.

💡 Gợi ý: 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 và tìm kiếm. Hoạt động như một kỹ năng tác tử AI 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 khóa API 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: Máy chủ API và khóa phải khớp theo khu vực; 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
MINIMAP_API_KEY	lấy từ MiniMax Global	lấy từ MiniMax
MINIMAP_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: Khóa API phải khớp với máy chủ. Nếu gặp lỗi "API Error: invalid api key", vui lòng kiểm tra máy chủ API của bạn:

• Máy chủ Toàn cầu：https://api.minimax.io
• Máy chủ Trung Quốc đại lục：https://api.minimaxi.com

Nếu bạn đang sử dụng Windows, bạn sẽ cần bật "Developer Mode" trong Claude Desktop để sử dụng máy chủ MCP. 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. Máy khách MCP 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 đổi văn bản thành âm thanh với giọng nói nhất định
list_voices	Liệt kê tất cả các giọng nói có sẵn
voice_clone	Nhân bản giọng nói bằng cách sử dụng các tệp âm thanh được cung cấp
generate_video	Tạo video từ một lời nhắc
text_to_image	Tạo hình ảnh từ một lời nhắc
query_video_generation	Truy vấn kết quả của tác vụ tạo video
voice_design	Tạo giọng nói từ một lời nhắc 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

• Thiết kế giọng nói: Công cụ voice_design mới - tạo giọng nói tùy chỉnh từ các lời nhắc mô tả với âm thanh xem trước
• Cải tiến video: Đã thêm mô hình MiniMax-Hailuo-02 với chất lượng siêu rõ nét và các tùy chọn kiểm soát thời lượng/độ phân giải

📈 Công cụ nâng cao

• 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

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

1. invalid api key

Vui lòng đảm bảo khóa API và máy chủ API của bạn khớp theo khu vực

Khu vực	Toàn cầu	Trung Quốc đại lục
MINIMAP_API_KEY	lấy từ MiniMax Global	lấy từ MiniMax
MINIMAP_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

Khi bạn 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 một giọng nói

3. tạo một video

4. tạo hình ảnh