MiniMax MCP

официальный

Взаимодействуйте с мощными API MiniMax для генерации Text-to-Speech, изображений и видео.

Что можно делать с MiniMax MCP?

  • Преобразование текста в речь — Попросите ассистента преобразовать письменный текст в аудио, используя указанный голос.
  • Клонирование голоса — Клонируйте голос по предоставленным аудиофайлам, а затем используйте его для генерации речи.
  • Создание голоса — Создайте уникальный голос по описательному запросу и прослушайте предварительный вариант.
  • Генерация и редактирование изображений — Создавайте изображения по запросам с разрешением 1K/2K/4K или редактируйте изображение с помощью запроса и до 16 референсных изображений.
  • Генерация видео — Создавайте видео по запросу, выбирая длительность и разрешение, а затем запрашивайте результат выполнения задачи.

Документация

export

Официальный сервер MiniMax Model Context Protocol (MCP), обеспечивающий взаимодействие с мощными API для преобразования текста в речь и генерации видео и изображений. Этот сервер позволяет MCP-клиентам, таким как Claude Desktop, Cursor, Windsurf, OpenAI Agents и другим, генерировать речь, клонировать голоса, создавать видео и изображения и многое другое.

💡 Рекомендуем: MiniMax CLI (mmx-cli) — наш официальный инструмент командной строки с новейшими моделями и дополнительными возможностями, включая работу с текстом, изображениями и поиском. Работает как навык ИИ-агента для Claude Code, Cursor, OpenClaw и других.

Документация

Быстрый запуск с MCP-клиентом

  1. Получите API-ключ на сайте MiniMax.
  2. Установите uv (менеджер пакетов Python) с помощью curl -LsSf https://astral.sh/uv/install.sh | sh или ознакомьтесь с дополнительными способами установки в uv репозитории.
  3. Важно: адрес API-хоста и ключ зависят от региона и должны соответствовать друг другу; в противном случае возникнет ошибка Invalid API key.
РегионГлобальныйМатериковый Китай
MINIMAX_API_KEYполучите на сайте MiniMax 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. Нажмите «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Редактирование изображения с помощью MiniMax-H3-Image по запросу и 1–16 референсных изображений
query_video_generationЗапрос результата задачи генерации видео
voice_designСоздание голоса по запросу с использованием текста для предварительного прослушивания

Примечания к выпускам

10 ноября 2026 г.

🆕 Новое

  • Редактирование изображений: новый инструмент image_edit — редактирование изображений с помощью MiniMax-H3-Image по запросу и 1–16 референсных изображений (URL, URI данных, mm_file:// или локальный путь)
  • Генерация изображений 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", чтобы использовать предыдущую модель

2 июля 2025 г.

🆕 Новое

  • Дизайн голоса: новый инструмент voice_design — создание пользовательских голосов по описательным запросам с предварительным прослушиванием аудио
  • Улучшение видео: добавлена модель MiniMax-Hailuo-02 с повышенной четкостью и настройками длительности и разрешения

📈 Улучшенные инструменты

  • voice_design — создание персонализированных голосов по текстовым описаниям
  • generate_video — теперь поддерживается MiniMax-Hailuo-02 с вариантами длительности 6 с/10 с и разрешения 768P/1080P

Часто задаваемые вопросы

1. invalid api key

Убедитесь, что API-ключ и API-хост соответствуют региону

РегионГлобальныйМатериковый Китай
MINIMAX_API_KEYполучите на сайте MiniMax 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. Создать изображения