Каталог MCP
supertone-inc/supertone-mcp

supertone-inc/supertone-mcp

Name: supertone-inc/supertone-mcp
Availability: InStock
Author: supertone-inc

MCP-сервер для Supertone TTS с набором композитных инструментов: синтез речи, поиск и клонирование голосов, предсказание длительности, управление кредитами. Поддерживает 31 язык, настройки темпа, тона и эмоций. Полезен разработчикам для интеграции голосового вывода в LLM-клиенты (Claude Desktop, ...

Github PyPi Сайт сервера

README

14 инструментов

Версии

Установить сервер

supertone-mcp

Осторожно

⚠️ Service Discontinuation Notice

The Supertone API will be permanently shut down on August 31, 2026. After this date, all API requests will stop being served and this package will no longer work.

👉 For the full timeline, refund policy, and details, see the End-of-Life Guide.

A composable MCP toolkit for the Supertone TTS API. Rather than a single "speak this text" command, it exposes Supertone's SDK as a set of building-block tools — synthesis, voice discovery, preview, duration/credit prediction, usage tracking, and full voice-cloning CRUD — that an LLM assembles to fulfill a request. Works in Claude Desktop, Cursor, or any MCP-compatible client.

Covers Korean, English, Japanese, and 31 languages total. Speed (0.5x–2.0x), pitch shift (-24 to +24 semitones), emotion styles, per-call output mode, streaming, and model selection.

Features

Synthesis

text_to_speech — Convert text to audio. Per-call control of output_mode (files / resources / both), autoplay, streaming, model, plus include_phonemes / normalized_text. Long text is auto-chunked by the SDK.
predict_duration — Estimate audio length (and credit cost) without synthesizing.

Инструменты были проиндексированы: 18.10.2026

clone_voice

Создаёт пользовательский голос из одного локального аудиофайла. Ограничения: только WAV или MP3, макс. 3 МБ, ровно один файл. Возвращённый voice_id можно сразу использовать в text_to_speech. Путь поддерживает раскрытие ~ (например, "~/sample.wav").

Параметры

audio_pathstringобязательный
descriptionstring | null
namestringобязательный

delete_custom_voice

Навсегда удаляет кастомный (клонированный) голос. ЭТО НЕОБРАТИМО — после удаления голос нельзя восстановить, а любой сохранённый voice_id, ссылающийся на него, перестанет работать. Перед вызовом подтвердите с пользователем.

Параметры

voice_idstringобязательный

edit_custom_voice

Обновляет имя и/или описание существующего пользовательского голоса. Необходимо указать хотя бы имя или описание.

Параметры

descriptionstring | null
namestring | null
voice_idstringобязательный

get_credit_balance

Возвращает оставшийся кредитный баланс Supertone для текущего API-ключа. Используйте это перед длинными TTS-вызовами, чтобы убедиться, что у вас осталось достаточно символов.

Параметры

Без параметров.

get_custom_voice

Получает данные о конкретном пользовательском (клонированном) голосе по voice_id. Возвращает имя и описание голоса. Используйте search_custom_voice, чтобы вывести список пользовательских голосов и найти voice_id.

Параметры

voice_idstringобязательный

get_usage_history

Получает историю использования TTS API для текущего ключа API. Возвращает текстовую сводку, разбитую по временным периодам, с указанием использованных минут (и, где доступно, голоса и модели) в каждом периоде. Не принимает параметров: отчёт за недавний период по умолчанию. Используйте это, чтобы проверить, сколько синтеза было израсходовано.

Параметры

Без параметров.

get_voice

Получает полные сведения об одном голосе по voice_id. Возвращает имя, описание, возраст, пол, варианты использования, языки, стили, поддерживаемые модели, количество образцов и URL миниатюры. Используйте preview_voice, чтобы получить фактические URL аудиообразцов.

Параметры

voice_idstringобязательный

get_voice_usage

Получает недавнее использование одного голоса по voice_id. Возвращает текстовую сводку с ежедневным использованием голоса в минутах за последний период по умолчанию. Используйте search_voice или search_custom_voice, чтобы найти voice_id.

Параметры

voice_idstringобязательный

merge_audio_files

Объединяет два или более локальных аудиофайла в один с помощью ffmpeg. Поддерживает простое склеивание, вставку тишины между фрагментами (gap_ms) или скрещивание с перекрёстным затуханием (crossfade_ms). gap_ms и crossfade_ms взаимоисключают друг друга. Формат выходного файла определяется автоматически по входным (все одного расширения → это расширение; смешанные → mp3) или переопределяется через output_format. Используйте, чтобы сшить несколько результатов text_to_speech в один готовый файл.

Параметры

crossfade_msinteger
gap_msinteger
input_pathsstring[]обязательный
output_formatstring | null

predict_duration

Предсказывает ожидаемую длительность аудиовыхода в секундах для заданного текста БЕЗ создания аудиофайла. Принимает те же параметры, что и text_to_speech. Ограничения по длине текста нет: длинный текст автоматически разбивается на части, а расход кредитов и задержка масштабируются пропорционально длине текста. Используйте это, чтобы оценить стоимость кредитов перед синтезом — расход кредитов пропорционален предсказанной длительности.

Параметры

languagestring | null
modelstring | null
output_formatstring | null
pitch_shiftinteger | null
speednumber | null
stylestring | null
textstringобязательный
voice_idstring | null

preview_voice

Получает ссылки на образцы аудио для голоса. Можно отфильтровать образцы по языку, стилю и модели. Возвращает один URL на каждый подходящий образец. v0.2 НЕ воспроизводит аудио локально — передайте URL вашему клиенту для прослушивания.

Параметры

languagestring | null
modelstring | null
stylestring | null
voice_idstringобязательный

search_custom_voice

Выводит список пользовательских (клоновых) голосов, созданных с помощью этого API-ключа. Опциональные фильтры по имени и описанию выполняют частичное совпадение. Пагинация обрабатывается внутри; v0.2 возвращает страницу по умолчанию для SDK.

Параметры

descriptionstring | null
namestring | null

search_voice

Поиск по каталогу голосов Supertone. Фильтры необязательны и комбинируются по логике AND: name, description, language, gender, age, use_case, style, model. Без фильтров возвращается полный каталог (поведение v0.1 list_voices). Результат — нумерованный список в виде обычного текста; когда задан хотя бы один фильтр, первая строка показывает "Filters applied: ...".

Параметры

agestring | null
descriptionstring | null
genderstring | null
languagestring | null
modelstring | null
namestring | null
stylestring | null
use_casestring | null

text_to_speech

Генерирует естественно звучащую речь из текста. Используй это, когда пользователь хочет: услышать текст вслух, создать озвучку или голос за кадром, сгенерировать голосовое аудио, послушать, как текст звучит в устной форме, или превратить любой текст в звук. Поддерживается 31 язык, включая корейский, английский и японский. Ограничения по длине текста нет: длинный текст сервис автоматически разбивает на части (автоматическое дробление), а расход кредитов и задержка масштабируются пропорционально длине текста. Задай output_mode ('files', 'resources' или 'both'), чтобы управлять способом возврата аудио, и autoplay=true для воспроизведения на macOS. Эти параметры при каждом вызове ЗАМЕНЯЮТ удалённые переменные окружения SUPERTONE_MCP_OUTPUT_MODE и SUPERTONE_MCP_AUTOPLAY; теперь autoplay по умолчанию выключен. Голос по умолчанию уже настроен — просто вызывай этот инструмент напрямую. Обращайся к search_voice, только если пользователь явно попросит сменить или посмотреть голоса.

Параметры

autoplayboolean
include_phonemesboolean
Если значение true, запрашивает данные о времени фонем вместе с аудио (SDK 0.2.3). По умолчанию false. Примечание: данные о фонемах пока не отображаются в ответе инструмента: это временный сквозной флаг.
languagestring | null
modelstring | null
normalized_textstring | null
Необязательный предварительно нормализованный текст для синтеза (SDK 0.2.3). Применяется только к моделям sona_speech_2 и sona_speech_2_flash; остальные модели игнорируют его. Если параметр опущен, используется значение по умолчанию SDK (None).
output_formatstring | null
output_modestring | null
pitch_shiftinteger | null
speednumber | null
streamingboolean
Когда задано true, аудио передаётся потоково через путь чанкованного синтеза вместо одного разового запроса. Потоковая передача поддерживается ТОЛЬКО для model=sona_speech_1; использование streaming=true с любой другой моделью возвращает ошибку валидации. По умолчанию false (разовый синтез).
stylestring | null
textstringобязательный
voice_idstring | null

`0.3.1`основная	17.06.2026
`0.3.0`	16.06.2026
`0.2.0`	05.06.2026
`0.1.1`	27.05.2026
`0.1.0`	27.05.2026

Выберите клиент, чтобы установить supertone-inc/supertone-mcp:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "supertone-inc-supertone-mcp-29nsvpo86d": {
      "command": "uvx",
      "args": [
        "supertone-mcp"
      ],
      "env": {
        "SUPERTONE_API_KEY": "your-api-key-here"
      }
    }
  }
}

Cursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "supertone-inc-supertone-mcp-29nsvpo86d": {
      "command": "uvx",
      "args": [
        "supertone-mcp"
      ],
      "env": {
        "SUPERTONE_API_KEY": "your-api-key-here"
      }
    }
  }
}

VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "supertone-inc-supertone-mcp-29nsvpo86d": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "supertone-mcp"
      ],
      "env": {
        "SUPERTONE_API_KEY": "your-api-key-here"
      }
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"supertone-inc-supertone-mcp-29nsvpo86d\",\"type\":\"stdio\",\"command\":\"uvx\",\"args\":[\"supertone-mcp\"],\"env\":{\"SUPERTONE_API_KEY\":\"your-api-key-here\"}}"

Claude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "supertone-inc-supertone-mcp-29nsvpo86d": {
      "command": "uvx",
      "args": [
        "supertone-mcp"
      ],
      "env": {
        "SUPERTONE_API_KEY": "your-api-key-here"
      }
    }
  }
}

Claude Code

Добавьте сервер одной командой в терминале:

claude mcp add supertone-inc-supertone-mcp-29nsvpo86d --env SUPERTONE_API_KEY=your-api-key-here -- uvx supertone-mcp

Либо через JSON-конфиг:

claude mcp add-json supertone-inc-supertone-mcp-29nsvpo86d "{\"command\":\"uvx\",\"args\":[\"supertone-mcp\"],\"env\":{\"SUPERTONE_API_KEY\":\"your-api-key-here\"}}"

Codex

Добавьте сервер командой в терминале:

codex mcp add supertone-inc-supertone-mcp-29nsvpo86d --env SUPERTONE_API_KEY=your-api-key-here -- uvx supertone-mcp

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.supertone-inc-supertone-mcp-29nsvpo86d]
command = "uvx"
args = ["supertone-mcp"]

[mcp_servers.supertone-inc-supertone-mcp-29nsvpo86d.env]
SUPERTONE_API_KEY = "your-api-key-here"

Perplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

Откройте Настройки аккаунта → Connectors.
Установите вспомогательное приложение PerplexityXPC (один раз).
Нажмите Add Connector → вкладка Simple.
В поле Server Name укажите supertone-inc/supertone-mcp, а в поле команды запуска — строку ниже:

uvx supertone-mcp

Нажмите Save и дождитесь статуса Running.

Windsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "supertone-inc-supertone-mcp-29nsvpo86d": {
      "command": "uvx",
      "args": [
        "supertone-mcp"
      ],
      "env": {
        "SUPERTONE_API_KEY": "your-api-key-here"
      }
    }
  }
}

Cline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "supertone-inc-supertone-mcp-29nsvpo86d": {
      "command": "uvx",
      "args": [
        "supertone-mcp"
      ],
      "env": {
        "SUPERTONE_API_KEY": "your-api-key-here"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Continue

Создайте файл в .continue/mcpServers/ (например supertone-inc-supertone-mcp-29nsvpo86d.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: supertone-inc-supertone-mcp-29nsvpo86d
    command: uvx
    args:
      - "supertone-mcp"
    env:
      SUPERTONE_API_KEY: your-api-key-here

Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "supertone-inc-supertone-mcp-29nsvpo86d": {
      "command": "uvx",
      "args": [
        "supertone-mcp"
      ],
      "env": {
        "SUPERTONE_API_KEY": "your-api-key-here"
      }
    }
  }
}

Конфиг для установки сервера

{
  "command": "uvx",
  "args": [
    "supertone-mcp"
  ],
  "env": {
    "SUPERTONE_API_KEY": "your-api-key-here"
  }
}

Нужен uvx

Сервер запускается через uvx
Без него ничего работать не будет.

Как установить uvx

Информация о сервере

Номер в рейтинге: #198
Звезд на Github: 4
Форков на Github: 4
Загрузок: 1 676
Язык реализации: Python
Лицензия: неизвестно
Официальный сервер: Нет
Дата обновления данных: 19.10 в 11:01
Идентификатор: qyr_5g1ibKecFf3j
Категории: Обработка речи

supertone-inc/supertone-mcp

supertone-mcp

⚠️ Service Discontinuation Notice

Features

Похожие MCP-сервера

elevenlabs/elevenlabs-mcp

waxberry-dev/live-translate-mcp

mohitbadwal/ringback

mbailey/voice-mcp

eviscerations/whisper-windows-mcp

JuhongPark/mcp-server-pronunciation