MiniMax MCP

공식

MiniMax의 강력한 텍스트 음성 변환, 이미지 및 비디오 생성 API와 상호작용하세요.

MiniMax MCP(으)로 무엇을 할 수 있나요?

  • 텍스트 음성 변환 — 지정한 음성을 사용해 작성된 텍스트를 오디오로 변환하도록 어시스턴트에게 요청합니다.
  • 음성 복제 — 제공한 오디오 파일에서 음성을 복제한 다음, 음성 생성에 다시 사용합니다.
  • 음성 디자인 — 설명형 프롬프트와 미리 듣기 오디오를 사용해 맞춤 음성을 생성합니다.
  • 이미지 생성 및 편집 — 프롬프트로 1K/2K/4K 영역의 이미지를 생성하거나, 프롬프트와 최대 16개의 참조 이미지를 사용해 이미지를 편집합니다.
  • 동영상 생성 — 프롬프트로 동영상을 생성하고, 길이와 해상도를 선택한 다음 작업 결과를 조회합니다.

문서

export

강력한 텍스트 음성 변환 및 동영상/이미지 생성 API와 상호작용할 수 있도록 지원하는 공식 MiniMax Model Context Protocol(MCP) 서버입니다. 이 서버를 사용하면 Claude Desktop, Cursor, Windsurf, OpenAI Agents 등의 MCP 클라이언트에서 음성 생성, 음성 복제, 동영상 생성, 이미지 생성 등을 수행할 수 있습니다.

💡 권장: MiniMax CLI (mmx-cli) — 최신 모델과 텍스트, 비전, 검색 등의 추가 기능을 제공하는 공식 명령줄 도구입니다. Claude Code, Cursor, OpenClaw 등의 AI 에이전트 스킬로 사용할 수 있습니다.

문서

MCP 클라이언트 빠른 시작

  1. MiniMax에서 API 키를 발급받습니다.
  2. uv (Python 패키지 관리자)를 설치하고, curl -LsSf https://astral.sh/uv/install.sh | sh을 사용해 설치하거나 추가 설치 방법은 uv 저장소를 참조하세요.
  3. 중요: API 호스트와 키는 지역에 따라 다르며 서로 일치해야 합니다. 일치하지 않으면 Invalid API key 오류가 발생합니다.
지역글로벌중국 본토
MINIMAX_API_KEYMiniMax Global에서 발급MiniMax에서 발급
MINIMAX_API_HOSThttps://api.minimax.iohttps://api.minimaxi.com

Claude Desktop

Claude > Settings > Developer > Edit Config > claude_desktop_config.json으로 이동하여 다음을 포함하세요.

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

⚠️ 경고: API 키는 호스트와 일치해야 합니다. "API Error: invalid api key" 오류가 발생하면 API 호스트를 확인하세요.

  • 글로벌 호스트:https://api.minimax.io
  • 중국 본토 호스트:https://api.minimaxi.com

Windows를 사용하는 경우 MCP 서버를 사용하려면 Claude Desktop에서 "Developer Mode"를 활성화해야 합니다. 왼쪽 상단의 햄버거 메뉴에서 "Help"를 클릭하고 "Enable Developer Mode"를 선택하세요.

Cursor

위 구성을 추가하려면 Cursor -> Preferences -> Cursor Settings -> MCP -> Add new global MCP Server으로 이동하세요.

이제 MCP 클라이언트에서 다음 도구를 통해 MiniMax와 상호작용할 수 있습니다.

전송 방식

stdio와 sse, 두 가지 전송 방식을 지원합니다.

stdioSSE
로컬에서 실행로컬 또는 클라우드에 배포 가능
stdout을 통한 통신network을 통한 통신
입력: local files 또는 유효한 URL 리소스 처리 지원입력: 클라우드에 배포하는 경우 입력에 URL 사용을 권장

사용 가능한 도구

도구설명
text_to_audio지정한 음성으로 텍스트를 오디오로 변환
list_voices사용 가능한 모든 음성 목록 표시
voice_clone제공된 오디오 파일을 사용해 음성 복제
generate_video프롬프트로 동영상 생성
text_to_image프롬프트로 이미지 생성. 기본값은 MiniMax-H3-Image입니다(area 1K/2K/4K 및 size 지원). image-01은(는) model을(를) 통해 계속 사용할 수 있습니다.
image_edit프롬프트와 1~16개의 참조 이미지를 사용해 MiniMax-H3-Image로 이미지 편집
query_video_generation동영상 생성 작업 결과 조회
voice_design미리보기 텍스트를 사용해 프롬프트로 음성 생성

릴리스 노트

2026년 11월 10일

🆕 새로운 기능

  • 이미지 편집: 새로운 image_edit 도구 — 프롬프트와 1~16개의 참조 이미지(URL, 데이터 URI, mm_file:// 또는 로컬 경로)를 사용해 MiniMax-H3-Image로 이미지 편집
  • H3 이미지 생성: text_to_image의 기본 모델이 MiniMax-H3-Image로 변경되었으며 area(1K/2K/4K) 및 size을 지원합니다. image-01은(는) model 매개변수를 통해 계속 사용할 수 있습니다.

📈 도구 개선

  • text_to_image - 기본 모델은 MiniMax-H3-Image(/v1/images/generations)입니다. 이전 모델을 사용하려면 model="image-01"을 전달하세요.

2025년 7월 2일

🆕 새로운 기능

  • 음성 디자인: 새로운 voice_design 도구 - 설명형 프롬프트와 미리보기 오디오를 사용해 사용자 지정 음성 생성
  • 동영상 향상: 선명한 화질과 길이/해상도 제어 기능을 갖춘 MiniMax-Hailuo-02 모델 추가

📈 도구 개선

  • voice_design - 텍스트 설명으로 개인화된 음성 생성
  • generate_video - 이제 6초/10초 길이와 768P/1080P 해상도 옵션을 갖춘 MiniMax-Hailuo-02 지원

FAQ

1. API 키가 유효하지 않음

API 키와 API 호스트가 같은 지역에 해당하는지 확인하세요.

지역글로벌중국 본토
MINIMAX_API_KEYMiniMax Global에서 발급MiniMax에서 발급
MINIMAX_API_HOSThttps://api.minimax.iohttps://api.minimaxi.com

2. spawn uvx ENOENT

터미널에서 다음 명령을 실행하여 절대 경로를 확인하세요.

which uvx

절대 경로(예: /usr/local/bin/uvx)를 확인한 후, 해당 경로를 사용하도록 구성을 업데이트하세요(예: "command": "/usr/local/bin/uvx").

3. 비동기 모드에서 generate_video 사용 방법

시작하기 전에 완료 규칙을 정의하세요. 또는 IDE 설정(예: Cursor)에서 이러한 규칙을 구성할 수 있습니다.

사용 예시

⚠️ 경고: 이러한 도구를 사용하면 비용이 발생할 수 있습니다.

1. 저녁 뉴스 일부를 방송하기

2. 음성 복제

3. 동영상 생성

4. 이미지 생성