mmx-mcp-server

mmx CLI를 기반으로 래핑된 통합 MiniMax 전 모달 MCP 서버로, 텍스트, 검색, 이미지 이해, 이미지 생성, 음성 합성, 비디오 생성, 음악 생성 및 할당량 조회를 지원합니다.

English README

빠른 시작 (한 줄 설정)

Claude Code, OpenCode 또는 MCP를 지원하는 다른 AI CLI 도구를 사용하는 경우, 아래 내용을 AI에게 그대로 전달하세요:

帮我安装并配置 mmx-mcp-server：

1. 全局安装 mmx-cli（npm install -g mmx-cli）

2. 克隆 https://github.com/zth0828/mmx-mcp-server 到任意目录，执行 npm install && npm run build

3. 在我的 MCP 配置文件（如 ~/.claude/settings.json）里添加 mmx server，指向构建产物 dist/index.js

4. 向我要 MiniMax API Key，并通过 env.MINIMAX_API_KEY 注入

5. 完成后告诉我配置结果

수동 설치

1. mmx CLI 설치 (아직 설치하지 않은 경우)

npm install -g mmx-cli

설치 확인:

mmx --version

2. MCP Server 설치 및 빌드

git clone https://github.com/zth0828/mmx-mcp-server.git
cd mmx-mcp-server
npm install
npm run build

3. API Key 설정

MCP 클라이언트 설정(예: ~/.claude/settings.json)에 다음을 추가합니다:

방식 1: 환경 변수로 API Key 전달 (권장)

{
  "mcpServers": {
    "mmx": {
      "command": "node",
      "args": ["/path/to/mmx-mcp-server/dist/index.js"],
      "env": {
        "MINIMAX_API_KEY": "sk-xxxxx"
      }
    }
  }
}

방식 2: 명령줄 인수로 API Key 전달

env 작성이 어려운 MCP 클라이언트에 적합합니다:

{
  "mcpServers": {
    "mmx": {
      "command": "node",
      "args": [
        "/path/to/mmx-mcp-server/dist/index.js",
        "--api-key",
        "sk-xxxxx"
      ]
    }
  }
}

방식 3: mmx CLI 로컬 로그인 의존

앞의 두 방식을 설정하지 않은 경우, 서버는 자동으로 mmx CLI 자체의 인증 상태로 돌아갑니다(사전에 mmx auth login --api-key sk-xxxxx를 실행해야 함). 이 방식은 로컬 기기 사용에만 적합합니다.

출력 디렉토리 사용자 지정 (선택 사항)

기본적으로 생성된 이미지, 비디오, 음악, 음성은 현재 작업 디렉토리의 하위 폴더에 자동으로 저장됩니다:

• mmx_image/ — 이미지

• mmx_video/ — 비디오

• mmx_music/ — 음악

• mmx_speech/ — 음성

다른 위치에 통합 저장하고 싶다면 환경 변수 MMX_OUTPUT_DIR을 통해 수정할 수 있습니다:

{
  "mcpServers": {
    "mmx": {
      "command": "node",
      "args": ["/path/to/mmx-mcp-server/dist/index.js"],
      "env": {
        "MINIMAX_API_KEY": "sk-xxxxx",
        "MMX_OUTPUT_DIR": "/Users/xxx/Downloads/mmx-output"
      }
    }
  }
}

MMX_OUTPUT_DIR을 설정하지 않아도 사용에는 전혀 지장이 없으며, 파일은 자동으로 현재 프로젝트 디렉토리에 저장됩니다.

호출할 때마다 out 매개변수를 통해 개별 파일의 출력 경로를 지정할 수도 있습니다.

제공되는 Tools

사용 예시

설정이 완료되면 Claude Code에서 바로 다음과 같이 말할 수 있습니다:

"MiniMax의 최신 뉴스를 검색해 줘" "이 UI 디자인 도면을 분석해서 최적화 제안을 해 줘" "사이버펑크 스타일의 도시 야경 이미지를 생성해 줘" "이 텍스트를 음성으로 변환해 줘"