MiniMax MCP

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

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

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

• 中文文档
• MiniMax-MCP-JS — официальная реализация MiniMax MCP на JavaScript

Быстрый старт с 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_HOST	https://api.minimax.io	https://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, вам необходимо включить «Режим разработчика» в Claude Desktop, чтобы использовать MCP-сервер. Нажмите «Справка» в гамбургер-меню в левом верхнем углу и выберите «Включить режим разработчика».

Cursor

Перейдите в Cursor -> Preferences -> Cursor Settings -> MCP -> Add new global MCP Server, чтобы добавить указанную выше конфигурацию.

Всё готово. Ваш MCP-клиент теперь может взаимодействовать с MiniMax через эти инструменты:

Транспорт

Мы поддерживаем два типа транспорта: stdio и sse.

stdio	SSE
Запуск локально	Можно развернуть локально или в облаке
Связь через stdout	Связь через network
Ввод: поддерживает обработку local files или допустимых ресурсов URL	Ввод: при развертывании в облаке рекомендуется использовать URL для ввода

Доступные инструменты

инструмент	описание
text_to_audio	Преобразование текста в аудио с заданным голосом
list_voices	Список всех доступных голосов
voice_clone	Клонирование голоса с использованием предоставленных аудиофайлов
generate_video	Генерация видео по запросу
text_to_image	Генерация изображения по запросу
query_video_generation	Запрос результата задачи генерации видео
music_generation	Генерация музыкального трека по запросу и тексту песни
voice_design	Генерация голоса по запросу с использованием предварительного текста

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

2 июля 2025 г.

🆕 Что нового

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

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

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

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

1. invalid api key

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

Регион	Глобальный	Материковый Китай
MINIMAX_API_KEY	получить на MiniMax Global	получить на MiniMax
MINIMAX_API_HOST	https://api.minimax.io	https://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. генерация изображений