MiniMax MCP
официальныйВзаимодействуйте с мощными API MiniMax для генерации Text-to-Speech, изображений и видео.
Что можно делать с MiniMax MCP?
- Преобразование текста в речь — Попросите ассистента преобразовать письменный текст в аудио, используя указанный голос.
- Клонирование голоса — Клонируйте голос по предоставленным аудиофайлам, а затем используйте его для генерации речи.
- Создание голоса — Создайте уникальный голос по описательному запросу и прослушайте предварительный вариант.
- Генерация и редактирование изображений — Создавайте изображения по запросам с разрешением 1K/2K/4K или редактируйте изображение с помощью запроса и до 16 референсных изображений.
- Генерация видео — Создавайте видео по запросу, выбирая длительность и разрешение, а затем запрашивайте результат выполнения задачи.
Документация

Официальный сервер 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-клиентом
- Получите API-ключ на сайте MiniMax.
- Установите
uv(менеджер пакетов Python) с помощьюcurl -LsSf https://astral.sh/uv/install.sh | shили ознакомьтесь с дополнительными способами установки вuvрепозитории. - Важно: адрес 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, для работы с MCP-сервером необходимо включить «Режим разработчика» в Claude Desktop. Нажмите «Help» в меню-гамбургере в левом верхнем углу и выберите «Enable Developer Mode».
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 | Создание изображения по запросу. По умолчанию используется 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_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. Создать изображения
