io.github.theYahia/salutespeech-mcp
MCP server for Sber SaluteSpeech API — speech recognition and synthesis.
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
@theyahia/salutespeech-mcpclaude mcp add salutespeech-mcp -e 'SALUTE_AUTH_KEY=<your salute_auth_key>' -- npx -y @theyahia/salutespeech-mcp@1.0.0
{
"mcpServers": {
"salutespeech-mcp": {
"command": "npx",
"args": [
"-y",
"@theyahia/salutespeech-mcp@1.0.0"
],
"env": {
"SALUTE_AUTH_KEY": "<your salute_auth_key>"
}
}
}
}
Variables d'environnement
SALUTE_AUTH_KEYobligatoire secret API key for the service
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
Sommaire
SaluteSpeech MCP — распознавание и синтез русской речи для ИИ-ассистента
Если вы искали, как расшифровать созвон или голосовое сообщение в текст, озвучить текст голосом Сбера или подключить русский speech-to-text к Claude без собственного бэкенда — это оно. 5 инструментов поверх Sber SaluteSpeech API: распознавание речи (STT) и синтез речи (TTS).
Часть серии WWmcp (46 серверов) от @theYahia.
Установка
Claude Desktop
{
"mcpServers": {
"salutespeech": {
"command": "npx",
"args": ["-y", "@theyahia/salutespeech-mcp"],
"env": { "SALUTESPEECH_API_KEY": "your-base64-key" }
}
}
}
Claude Code
claude mcp add salutespeech -e SALUTESPEECH_API_KEY=your-key -- npx -y @theyahia/salutespeech-mcp
Режим Streamable HTTP
SALUTESPEECH_API_KEY=your-key npx @theyahia/salutespeech-mcp --http --port=3000
# POST http://localhost:3000/mcp
# GET http://localhost:3000/health
Авторизация
Три варианта (проверяются по порядку):
| Переменная | Формат |
|---|---|
SALUTESPEECH_API_KEY | Base64 от строки client_id:client_secret |
SALUTE_AUTH_KEY | То же самое (устаревший алиас) |
SALUTE_SPEECH_CLIENT_ID + SALUTE_SPEECH_CLIENT_SECRET | Сырые учётные данные (кодируются автоматически) |
OAuth-токены запрашиваются и обновляются автоматически. Scope по умолчанию —
SALUTE_SPEECH_PERS (физлица); для корпоративных аккаунтов задайте SALUTE_SPEECH_SCOPE
(SALUTE_SPEECH_CORP — постоплата, SALUTE_SPEECH_B2B — предоплата).
Учётные данные выдаются на developers.sber.ru.
Инструменты (5)
| Инструмент | Описание |
|---|---|
recognize_speech | Распознавание речи из аудио в Base64 |
synthesize_speech | Синтез речи, возвращает аудио в Base64 |
list_models | Список моделей распознавания и голосов синтеза |
get_task_status | Статус асинхронной задачи распознавания |
recognize_file | Распознавание речи из локального файла по пути |
Навыки (Skills)
skill-transcribe— пошаговый сценарий расшифровки аудиоskill-synthesize— пошаговый сценарий синтеза речи
Примеры
Расшифруй аудиофайл /tmp/meeting.wav
Озвучь «Привет, мир» голосом Bys_24000 в формате wav16
Покажи доступные голоса
Ограничения
recognize_speech и recognize_file работают через синхронный эндпоинт с лимитом
2 МБ / 1 минута аудио (файл больше — HTTP 413). Для многоканального аудио распознаётся
только первый канал. Длинные записи требуют асинхронного сценария
(data:upload → speech:async_recognize → task:get → data:download) — он пока не вынесен
в инструменты; шаг опроса статуса покрывает get_task_status.
Текст для синтеза ограничен 4000 символами (включая пробелы и SSML-разметку).
Решение проблем
self-signed certificate in certificate chain / UNABLE_TO_VERIFY_LEAF_SIGNATURE
Эндпоинты Сбера используют Russian Trusted Root CA (НУЦ Минцифры), которого нет в дефолтном хранилище доверенных корневых сертификатов Node.js — поэтому самый первый OAuth-запрос падает, пока вы его не добавите.
Решение: скачайте корневой сертификат (russian_trusted_root_ca_pem.crt) с
gosuslugi.ru/crt и укажите его Node.js:
export NODE_EXTRA_CA_CERTS=/path/to/russian_trusted_root_ca_pem.crt
В MCP-клиенте добавьте эту переменную в блок env сервера. Не ставьте
NODE_TLS_REJECT_UNAUTHORIZED=0 в продакшене — это полностью отключает проверку TLS.
Официальная инструкция: сертификаты SaluteSpeech.
Лицензия
MIT
Questions fréquentes
Qu'est-ce que io.github.theYahia/salutespeech-mcp ?
MCP server for Sber SaluteSpeech API — speech recognition and synthesis.
Comment installer io.github.theYahia/salutespeech-mcp ?
Il s'exécute sur votre machine. Dans Claude Code : claude mcp add salutespeech-mcp -e 'SALUTE_AUTH_KEY=<your salute_auth_key>' -- npx -y @theyahia/salutespeech-mcp@1.0.0. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour io.github.theYahia/salutespeech-mcp ?
Oui. Il attend SALUTE_AUTH_KEY, à renseigner dans sa configuration.
io.github.theYahia/salutespeech-mcp est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient io.github.theYahia/salutespeech-mcp ?
Il est publié par theYahia. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.