MiniMax MCP
chính thứcTươ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

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
- Tài liệu tiếng Trung
- MiniMax-MCP-JS - Bản triển khai JavaScript chính thức của MiniMax MCP
Bắt đầu nhanh với ứng dụng khách MCP
- Lấy khóa API của bạn từ MiniMax.
- Cài đặt
uv(trình quản lý gói Python), cài đặt bằngcurl -LsSf https://astral.sh/uv/install.sh | shhoặc xemuvkho lưu trữ để biết thêm các phương thức cài đặt. - 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ự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
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.
| 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 dùng URL làm đầu vào |
Các công cụ hiện có
| công cụ | mô tả |
|---|---|
text_to_audio | Chuyển văn bản thành âm thanh bằng giọng nói được chỉ định |
list_voices | Liệt kê tất cả giọng nói hiện có |
voice_clone | Sao chép giọng nói bằng các tệp âm thanh được cung cấp |
generate_video | Tạo video từ câu lệnh |
text_to_image | Tạ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_edit | 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 |
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ừ 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_editmớ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_imagehiện mặc định dùng MiniMax-H3-Image và hỗ trợarea(1K/2K/4K) cùngsize;image-01vẫ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ềnmodel="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_designmớ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-02vớ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ảngenerate_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ự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 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
