mmx-mcp-server

Унифицированный мультимодальный MCP-сервер MiniMax, основанный на CLI mmx, поддерживающий текст, поиск, понимание изображений, генерацию изображений, синтез речи, генерацию видео, генерацию музыки и запрос квот.

English README

Быстрый старт (настройка одной фразой)

Если вы используете Claude Code, OpenCode или другие инструменты AI CLI с поддержкой MCP, просто отправьте ИИ следующую фразу:

Помоги мне установить и настроить 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. Добавь сервер mmx в мой конфигурационный файл MCP (например, ~/.claude/settings.json), указав путь к сборке dist/index.js

4. Запроси у меня MiniMax API Key и внедри его через env.MINIMAX_API_KEY

5. После завершения сообщи мне результат настройки

Ручная установка

1. Установка CLI mmx (если еще не установлен)

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 через аргументы командной строки

Подходит для клиентов MCP, где неудобно прописывать env:

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

Способ 3: Использование локальной авторизации CLI mmx

Если первые два способа не настроены, сервер автоматически вернется к состоянию авторизации самого CLI mmx (необходимо предварительно выполнить 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.

Предоставляемые инструменты

Примеры использования

После завершения настройки вы можете прямо в Claude Code сказать:

"Помоги мне найти последние новости о MiniMax" "Проанализируй этот макет UI и дай рекомендации по оптимизации" "Сгенерируй изображение ночного города в стиле киберпанк" "Преобразуй этот текст в речь"