MiniMax MCP Server

chính thức

Tương tác với các API tạo văn bản thành giọng nói, hình ảnh và video mạnh mẽ của MiniMax.

GitHub
1.5k

Tài liệu

export

Máy chủ Model Context Protocol (MCP) chính thức của MiniMax cho phép tương tác với các API Chuyển văn bản thành giọng nói và tạo video/hình ảnh mạnh mẽ. 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à hơn thế nữa.

💡 Khuyến nghị: 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à bìa nhạc. Hoạt động như một kỹ năng tác nhân 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 repo để biết các phương thức cài đặt bổ sung.
  3. Quan trọng: Máy chủ API và khóa 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ự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

Đi tới Claude > Settings > Developer > Edit Config > claude_desktop_config.json để bao gồm những điều 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 cần 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 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ẽ phải bật "Chế độ nhà phát triển" trong Claude Desktop để sử dụng máy chủ MCP. Nhấp vào "Trợ giúp" trong menu hamburger ở góc trên bên trái và chọn "Bật Chế độ nhà phát triển".

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. Ứng dụng khách MCP của bạn giờ đây có thể tương tác với MiniMax thông qua các công cụ sau:

Phương thức truyền tải

Chúng tôi hỗ trợ hai loại phương 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ý tài nguyên local files hoặc 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ông cụ khả dụng

công cụmô tả
text_to_audioChuyển đổi văn bản thành âm thanh với một giọng nói nhất định
list_voicesLiệt kê tất cả các giọng nói có sẵn
voice_cloneSao chép một giọng nói bằng các tệp âm thanh được cung cấp
generate_videoTạo video từ một lời nhắc
text_to_imageTạo hình ảnh từ một lời nhắc
query_video_generationTruy vấn kết quả của tác vụ tạo video
music_generationTạo một bản nhạc từ lời nhắc và lời bài hát
voice_designTạo giọng nói từ một lời nhắc sử dụ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
  • Nâng cao video: Đã thêm mô hình MiniMax-Hailuo-02 với chất lượng siêu nét và các điều khiển thời lượng/độ phân giải
  • Tạo nhạc: Công cụ music_generation nâng cao được hỗ trợ bởi mô hình music-1.5

📈 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 - Giờ đây 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
  • 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 khóa API và máy chủ API của bạn được căn chỉnh theo 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 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ế độ không đồng bộ

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 sóng một đoạn tin tức buổi tối

2. sao chép một giọng nói

3. tạo một video

4. tạo hình ảnh