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

экспорт

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

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

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

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

Функции

Преобразование текста в речь (TTS)
Генерация изображения
Генерация видео
Клонирование голоса
Динамическая конфигурация (поддерживает как переменные среды, так и параметры запроса)
Совместимость с хостингом платформы MCP (ModelScope и другие платформы MCP)

Установка

# Install with pnpm (recommended)
pnpm add minimax-mcp-js

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

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

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

Получите свой ключ API от MiniMax International Platform .
Убедитесь, что вы уже установили Node.js и npm
Важно: API HOST&KEY различаются в разных регионах , они должны совпадать, в противном случае вы получите ошибку Invalid API key .

Область	Глобальный	материк
MINIMAX_API_KEY	иди получи от MiniMax Global	иди получи от MiniMax
MINIMAX_API_HOST	https://api.minimaxi.chat (обратите внимание на дополнительную «i» )	https://api.minimax.chat

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

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

Клод Десктоп

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

{
  "mcpServers": {
    "minimax-mcp-js": {
      "command": "npx",
      "args": [
        "-y",
        "minimax-mcp-js"
      ],
      "env": {
        "MINIMAX_API_HOST": "<https://api.minimaxi.chat|https://api.minimax.chat>",
        "MINIMAX_API_KEY": "<your-api-key-here>",
        "MINIMAX_MCP_BASE_PATH": "<local-output-dir-path, such as /User/xxx/Desktop>",
        "MINIMAX_RESOURCE_MODE": "<optional, [url|local], url is default, audio/image/video are downloaded locally or provided in URL format>"
      }
    }
  }
}

Курсор

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

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

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

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

# In your project directory
npm link

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

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

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

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

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

Особенность	стандартный (по умолчанию)	ОТДЫХ	СШЭ
Среда	Только местный	Локальное или облачное развертывание	Локальное или облачное развертывание
Коммуникация	Через `standard I/O`	Через `HTTP requests`	Через `server-sent events`
Варианты использования	Интеграция локального клиента MCP	API-сервисы, кросс-языковые вызовы	Приложения, требующие принудительной загрузки сервера
Ограничения на ввод	Поддерживает `local files` или `URL` ресурсы	При развертывании в облаке рекомендуется вводить `URL`	При развертывании в облаке рекомендуется вводить `URL`

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

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

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

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

{
  "params": {
    "meta": {
      "auth": {
        "api_key": "your_api_key_here",
        "api_host": "<https://api.minimaxi.chat|https://api.minimaxi.chat>",
        "base_path": "/path/to/output",
        "resource_mode": "url"
      }
    }
  }
}

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

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

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

import { startMiniMaxMCP } from 'minimax-mcp-js';

await startMiniMaxMCP({
  apiKey: 'your_api_key_here',
  apiHost: 'https://api.minimaxi.chat', // Global Host - https://api.minimaxi.chat, Mainland Host - https://api.minimax.chat
  basePath: '/path/to/output',
  resourceMode: 'url'
});

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

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

# Install globally
pnpm install -g minimax-mcp-js

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

minimax-mcp-js --api-key your_api_key_here --api-host https://api.minimaxi.chat --base-path /path/to/output --resource-mode url

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

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

# MiniMax API Key (required)
MINIMAX_API_KEY=your_api_key_here

# Base path for output files (optional, defaults to user's desktop)
MINIMAX_MCP_BASE_PATH=~/Desktop

# MiniMax API Host (optional, defaults to https://api.minimaxi.chat, Global Host - https://api.minimaxi.chat, Mainland Host - https://api.minimax.chat)
MINIMAX_API_HOST=https://api.minimaxi.chat

# Resource mode (optional, defaults to 'url')
# Options: 'url' (return URLs), 'local' (save files locally)
MINIMAX_RESOURCE_MODE=url

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

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

Конфигурация на уровне запроса (через meta.auth в каждом запросе API)
Аргументы командной строки
Переменные среды
Файл конфигурации
Значения по умолчанию

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

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

Параметр	Описание	Значение по умолчанию
API-ключ	API-ключ MiniMax	Нет (обязательно)
apiHost	Хост API MiniMax	Глобальный хост - https://api.minimaxi.chat , материковый хост - https://api.minimax.chat
basePath	Базовый путь для выходных файлов	Рабочий стол пользователя
ресурсРежим	Режим обработки ресурсов: «url» или «local»	URL-адрес

Глобальный хост: 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 (например, курсор):

Разработка

Настраивать

# Clone the repository
git clone https://github.com/MiniMax-AI/MiniMax-MCP-JS.git
cd minimax-mcp-js

# Install dependencies
pnpm install

Строить

# Build the project
pnpm run build

Бегать

# Run the MCP server
pnpm start

Лицензия

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

You must be authenticated.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

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

Related MCP Servers

Together AI Image Server
zym9863
A
security
A
license
A
quality
A MCP server that enables Claude and other MCP-compatible assistants to generate images from text prompts using Together AI's image generation models.
Last updated -
1
2
TypeScript
MIT License
Minimax MCP Tools
PsychArch
A
security
A
license
A
quality
An MCP server implementation that integrates with Minimax API to provide AI-powered image generation and text-to-speech functionality in editors like Windsurf and Cursor.
Last updated -
2
192
1
JavaScript
MIT License
ElevenLabs MCP Serverofficial
elevenlabs
A
security
A
license
A
quality
An official Model Context Protocol (MCP) server that enables AI clients to interact with ElevenLabs' Text to Speech and audio processing APIs, allowing for speech generation, voice cloning, audio transcription, and other audio-related tasks.
Last updated -
19
700
Python
MIT License
MiniMax MCP Serverofficial
MiniMax-AI
A
security
A
license
A
quality
Enables MCP clients like Claude Desktop and Cursor to interact with MiniMax APIs for generating speech, cloning voices, creating videos, and generating images.
Last updated -
6
381
Python
MIT License

View all related MCP servers