МиниМакс МКП JS

Реализация MiniMax MCP на JavaScript/TypeScript, обеспечивающая генерацию изображений, генерацию видео, преобразование текста в речь и многое другое.

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

• 中文文档

• Версия Python — официальная реализация MiniMax MCP на Python

Related MCP server: Minimax MCP Tools

Функции

• Преобразование текста в речь (TTS)

• Генерация изображения

• Генерация видео

• Клонирование голоса

• Динамическая конфигурация (поддерживает как переменные среды, так и параметры запроса)

• Совместимость с хостингом платформы MCP (ModelScope и другие платформы MCP)

Установка

Быстрый старт

MiniMax MCP JS реализует спецификацию Model Context Protocol (MCP) и может использоваться в качестве сервера для взаимодействия с MCP-совместимыми клиентами (например, Claude AI).

Быстрый старт с MCP Client

1. Получите свой ключ API от MiniMax International Platform .

2. Убедитесь, что вы уже установили Node.js и npm

3. Важно: API HOST&KEY различаются в разных регионах , они должны совпадать, в противном случае вы получите ошибку Invalid API key .

Использование с клиентами MCP (рекомендуется)

Настройте свой MCP-клиент:

Клод Десктоп

Перейдите в Claude > Settings > Developer > Edit Config > claude_desktop_config.json , чтобы включить:

Курсор

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

⚠️ Примечание : если вы столкнулись с ошибкой «No tools found» при использовании MiniMax MCP JS с Cursor, обновите Cursor до последней версии. Для получения дополнительной информации см. эту ветку обсуждения .

Вот и все. Теперь ваш клиент MCP может взаимодействовать с MiniMax с помощью этих инструментов.

Для локальной разработки : при локальной разработке вы можете использовать npm link для тестирования своих изменений:

Затем настройте Claude Desktop или Cursor на использование npx, как показано выше. Это автоматически будет использовать вашу связанную версию.

⚠️ Примечание : API-ключ должен соответствовать адресу хоста. Для глобальной и китайской версий используются разные хосты:

• Глобальный хост: https://api.minimaxi.chat (обратите внимание на дополнительную «i»)

• Хост в материковом Китае: https://api.minimaxi.chat

Виды транспорта

MiniMax MCP JS поддерживает три режима транспортировки:

Конфигурация

MiniMax-MCP-JS предоставляет несколько гибких методов конфигурации для адаптации к различным вариантам использования. Приоритет конфигурации от самого высокого к самому низкому выглядит следующим образом:

1. Конфигурация параметров запроса (наивысший приоритет)

В средах хостинга платформ (например, ModelScope или других платформах MCP) вы можете предоставить независимую конфигурацию для каждого запроса с помощью объекта meta.auth в параметрах запроса:

Этот метод обеспечивает многопользовательское использование, при котором каждый запрос может использовать разные ключи API и конфигурации.

2. Конфигурация API

При использовании в качестве модуля в других проектах можно передать конфигурацию через функцию startMiniMaxMCP :

3. Аргументы командной строки

1. Установите инструмент CLI глобально:

2. При использовании в качестве инструмента CLI можно задать конфигурацию с помощью аргументов командной строки:

4. Переменные среды (самый низкий приоритет)

Самый простой метод настройки — через переменные среды:

Приоритет конфигурации

При использовании нескольких методов конфигурации применяется следующий порядок приоритетов (от высшего к низшему):

1. Конфигурация на уровне запроса (через meta.auth в каждом запросе API)

2. Аргументы командной строки

3. Переменные среды

4. Файл конфигурации

5. Значения по умолчанию

Такая расстановка приоритетов обеспечивает гибкость при различных сценариях развертывания, сохраняя при этом возможности конфигурации по запросу для многопользовательских сред.

Параметры конфигурации

⚠️ Примечание : API-ключ должен соответствовать адресу хоста. Для глобальной и китайской версий используются разные хосты:

• Глобальный хост: https://api.minimaxi.chat (обратите внимание на дополнительную «i»)

• Хост в материковом Китае: https://api.minimax.chat

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

⚠️ Внимание: использование этих инструментов может повлечь за собой расходы.

1. транслировать фрагмент вечерних новостей

2. клонировать голос

3. создать видео

4. генерировать изображения

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

Текст в аудио

Преобразовать текст в речевой аудиофайл.

Название инструмента: text_to_audio

Параметры:

• text : Текст для преобразования (обязательно)

• model : версия модели, варианты: «speech-02-hd», «speech-02-turbo», «speech-01-hd», «speech-01-turbo», «speech-01-240228», «speech-01-turbo-240228», по умолчанию «speech-02-hd»

• voiceId : идентификатор голоса, по умолчанию «male-qn-qingse»

• speed : скорость речи, диапазон 0,5–2,0, по умолчанию 1,0

• vol : Громкость, диапазон 0,1-10,0, по умолчанию 1,0

• pitch : Pitch, диапазон от -12 до 12, по умолчанию 0

• emotion : Emotion, варианты: «happy», «sad», «gry», «fearful», «disgusted», «surprised», «neutral», значение по умолчанию: «happy». Примечание: этот параметр работает только с моделями «speech-02-hd», «speech-02-turbo», «speech-01-turbo», «speech-01-hd».

• format : Аудиоформат, варианты: «mp3», «pcm», «flac», «wav», по умолчанию «mp3»

• sampleRate : Частота дискретизации (Гц), варианты: 8000, 16000, 22050, 24000, 32000, 44100, по умолчанию 32000

• bitrate : битрейт (бит/с), варианты: 64000, 96000, 128000, 160000, 192000, 224000, 256000, 320000, по умолчанию 128000

• channel : Аудиоканалы, варианты 1 или 2, по умолчанию 1

• languageBoost : усиление языка, по умолчанию «авто»

• latexRead : включить чтение формул LaTeX

• pronunciationDict : Словарь произношений

• stream : включить потоковый вывод

• subtitleEnable : Включить генерацию субтитров

• outputDirectory : Каталог для сохранения выходного файла (необязательно)

• outputFile : путь для сохранения выходного файла (необязательно, генерируется автоматически, если не указан)

Воспроизвести аудио

Воспроизвести аудиофайл. Поддерживает форматы WAV и MP3. Не поддерживает видео.

Имя инструмента: play_audio

Параметры:

• inputFilePath : Путь к аудиофайлу для воспроизведения (обязательно)

• isUrl : Является ли аудиофайл URL-адресом, по умолчанию false

Голосовой клон

Клонировать голос из аудиофайла.

Имя инструмента: voice_clone

Параметры:

• audioFile : Путь к аудиофайлу (обязательно)

• voiceId : идентификатор голоса (обязательно)

• text : Текст для демонстрационного аудио (необязательно)

• outputDirectory : Каталог для сохранения выходного файла (необязательно)

Текст в изображение

Создавайте изображения на основе текстовых подсказок.

Имя инструмента: text_to_image

Параметры:

• prompt : Описание изображения (обязательно)

• model : версия модели, по умолчанию «image-01»

• aspectRatio : Соотношение сторон, по умолчанию «1:1», варианты: «1:1», «16:9», «4:3», «3:2», «2:3», «3:4», «9:16», «21:9»

• n : Количество изображений для генерации, диапазон 1-9, по умолчанию 1

• promptOptimizer : следует ли оптимизировать подсказку, по умолчанию true

• subjectReference : Путь к локальному файлу изображения или общедоступный URL для ссылки на символ (необязательно)

• outputDirectory : Каталог для сохранения выходного файла (необязательно)

• outputFile : путь для сохранения выходного файла (необязательно, генерируется автоматически, если не указан)

• asyncMode : использовать ли асинхронный режим. По умолчанию False. Если True, задача генерации видео будет отправлена ​​асинхронно, а ответ вернет task_id. Следует использовать инструмент query_video_generation для проверки статуса задачи и получения результата. (необязательно)

Создать видео

Создавайте видеоролики на основе текстовых подсказок.

Название инструмента: generate_video

Параметры:

• prompt : Описание видео (обязательно)

• model : версия модели, варианты: «T2V-01», «T2V-01-Director», «I2V-01», «I2V-01-Director», «I2V-01-live», «S2V-01», по умолчанию «T2V-01»

• firstFrameImage : путь к изображению первого кадра (необязательно)

• outputDirectory : Каталог для сохранения выходного файла (необязательно)

• outputFile : путь для сохранения выходного файла (необязательно, генерируется автоматически, если не указан)

• asyncMode : использовать ли асинхронный режим. По умолчанию False. Если True, задача генерации видео будет отправлена ​​асинхронно, а ответ вернет task_id. Следует использовать инструмент query_video_generation для проверки статуса задачи и получения результата. (необязательно)

Запросить статус генерации видео

Запросить статус задачи генерации видео.

Название инструмента: query_video_generation

Параметры:

• taskId : идентификатор задачи для запроса. Должен быть task_id, возвращаемый инструментом generate_video , если async_mode имеет значение True. (обязательно)

• outputDirectory : Каталог для сохранения выходного файла (необязательно)

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

1. Как использовать generate_video в асинхронном режиме

Определите правила завершения перед началом: Кроме того, эти правила можно настроить в настройках IDE (например, курсор):

Разработка

Настраивать

Строить

Бегать

Лицензия

Массачусетский технологический институт