MiniMax MCP

chính thức

Tương tác với các API Text-to-Speech, tạo hình ảnh và video mạnh mẽ của MiniMax.

Bạn có thể làm gì với MiniMax MCP?

  • Chuyển văn bản thành giọng nói — Yêu cầu trợ lý chuyển văn bản thành âm thanh bằng giọng nói được chỉ định.
  • Nhân bản giọng nói — Nhân bản giọng nói từ các tệp âm thanh bạn cung cấp, sau đó dùng lại giọng đó để tạo lời nói.
  • Thiết kế giọng nói — Tạo giọng nói tùy chỉnh từ mô tả bằng lời nhắc, kèm âm thanh xem trước.
  • Tạo và chỉnh sửa hình ảnh — Tạo hình ảnh từ lời nhắc với diện tích 1K/2K/4K hoặc chỉnh sửa hình ảnh bằng lời nhắc và tối đa 16 hình ảnh tham chiếu.
  • Tạo video — Tạo video từ lời nhắc, với các tùy chọn về thời lượng và độ phân giải, rồi truy vấn kết quả tác vụ sau đó.

Tài liệu

export

Máy chủ MiniMax Model Context Protocol (MCP) chính thức, cho phép tương tác với các API mạnh mẽ để chuyển văn bản thành giọng nói và tạo video/hình ảnh. Máy chủ này cho phép các ứng dụng khách MCP như Claude Desktop, Cursor, Windsurf, OpenAI Agents và các ứng dụng khác tạo giọng nói, sao chép giọng nói, tạo video, tạo hình ảnh và nhiều tính năng khác.

💡 Khuyên dùng: MiniMax CLI (mmx-cli) — công cụ dòng lệnh chính thức của chúng tôi, tích hợp các mô hình mới nhất và nhiều tính năng bổ sung như 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

Bắt đầu nhanh với ứng dụng khách MCP

  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 kho lưu trữ để biết thêm các phương thức cài đặt.
  3. Quan trọng: Máy chủ API và khóa API thay đổi theo khu vực và phải khớp với nhau; nếu không, bạn sẽ gặp lỗi Invalid API key.
Khu vựcToàn cầuTrung Quốc đại lục
MINIMAX_API_KEYlấy từ MiniMax Globallấy từ MiniMax
MINIMAX_API_HOSThttps://api.minimax.iohttps://api.minimaxi.com

Claude Desktop

Truy cập Claude > Settings > Developer > Edit Config > claude_desktop_config.json để thêm nội dung 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 xảy ra lỗi "API Error: invalid api key", vui lòng kiểm tra máy chủ API:

  • 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 dùng Windows, bạn 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 rồi chọn "Enable Developer Mode".

Cursor

Truy cập Cursor -> Preferences -> Cursor Settings -> MCP -> Add new global MCP Server để thêm cấu hình ở trên.

Vậy là xong. Giờ đây, ứng dụng khách MCP của bạn 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.

stdioSSE
Chạy cục bộCó thể triển khai cục bộ hoặc trên đám mây
Giao tiếp qua stdoutGiao 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 dùng URL làm đầu vào

Các công cụ hiện có

công cụmô tả
text_to_audioChuyển văn bản thành âm thanh bằng giọng nói được chỉ định
list_voicesLiệt kê tất cả giọng nói hiện có
voice_cloneSao chép giọng nói bằng các tệp âm thanh được cung cấp
generate_videoTạo video từ câu lệnh
text_to_imageTạo hình ảnh từ câu lệnh. Mặc định là MiniMax-H3-Image (hỗ trợ area 1K/2K/4K và size); image-01 vẫn có thể dùng thông qua model
image_editChỉnh sửa hình ảnh bằng MiniMax-H3-Image với câu lệnh và 1-16 hình ảnh tham chiếu
query_video_generationTruy vấn kết quả của tác vụ tạo video
voice_designTạo giọng nói từ câu lệnh bằng văn bản xem trước

Ghi chú phát hành

Ngày 10 tháng 11 năm 2026

🆕 Có gì mới

  • Chỉnh sửa hình ảnh: Công cụ image_edit mới — chỉnh sửa hình ảnh bằng MiniMax-H3-Image với câu lệnh và 1-16 hình ảnh tham chiếu (URL, data URI, mm_file:// hoặc đường dẫn cục bộ)
  • Tạo hình ảnh H3: text_to_image hiện mặc định dùng MiniMax-H3-Image và hỗ trợ area (1K/2K/4K) cùng size; image-01 vẫn có thể dùng thông qua tham số model

📈 Công cụ được cải tiến

  • text_to_image - Mặc định dùng MiniMax-H3-Image (/v1/images/generations); truyền model="image-01" để dùng mô hình trước đó

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 câu lệnh mô tả, kèm âm thanh xem trước
  • Cải tiến video: Bổ sung mô hình MiniMax-Hailuo-02 với chất lượng siêu rõ nét và các tùy chọn điều khiển thời lượng/độ phân giải

📈 Công cụ được cải tiến

  • voice_design - Tạo giọng nói cá nhân hóa từ mô tả bằng văn bản
  • generate_video - Hiện hỗ trợ MiniMax-Hailuo-02 với các tùy chọn thời lượng 6s/10s và độ 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 thuộc cùng một khu vực

Khu vựcToàn cầuTrung Quốc đại lục
MINIMAX_API_KEYlấy từ MiniMax Globallấy từ MiniMax
MINIMAX_API_HOSThttps://api.minimax.iohttps://api.minimaxi.com

2. spawn uvx ENOENT

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

which uvx

Sau khi lấy được đường dẫn tuyệt đối (ví dụ: /usr/local/bin/uvx), hãy cập nhật cấu hình để 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 tất trước khi bắt đầu: Ngoài ra, bạn có thể cấu hình các quy tắc này trong phần cài đặt IDE (ví dụ: Cursor):

Ví dụ sử dụng

⚠️ Cảnh báo: Việc 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. sao chép giọng nói

3. tạo video

4. tạo hình ảnh