English Français العربية

io.github.theYahia/salutespeech-mcp

السجل الرسمي الوسائط والتصميم

MCP server for Sber SaluteSpeech API — speech recognition and synthesis.

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package @theyahia/salutespeech-mcp
Claude Code 
claude mcp add salutespeech-mcp -e 'SALUTE_AUTH_KEY=<your salute_auth_key>' -- npx -y @theyahia/salutespeech-mcp@1.0.0
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "salutespeech-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@theyahia/salutespeech-mcp@1.0.0"
            ],
            "env": {
                "SALUTE_AUTH_KEY": "<your salute_auth_key>"
            }
        }
    }
}

متغيرات البيئة

  • SALUTE_AUTH_KEY إلزامي سري API key for the service

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. SaluteSpeech MCP — распознавание и синтез русской речи для ИИ-ассистента
  2. Установка
  3. Авторизация
  4. Инструменты (5)
  5. Навыки (Skills)
  6. Примеры
  7. Ограничения
  8. Решение проблем
  9. Лицензия

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_KEYBase64 от строки 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

Часть WWmcp · Telegram: @vhodvai

الأسئلة الشائعة

ما هو io.github.theYahia/salutespeech-mcp؟

MCP server for Sber SaluteSpeech API — speech recognition and synthesis.

كيف أثبّت io.github.theYahia/salutespeech-mcp؟

يعمل على جهازك. في Claude Code: claude mcp add salutespeech-mcp -e 'SALUTE_AUTH_KEY=<your salute_auth_key>' -- npx -y @theyahia/salutespeech-mcp@1.0.0. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.theYahia/salutespeech-mcp إلى مفتاح API؟

نعم. يتطلب SALUTE_AUTH_KEY، وتضبطها في إعداداته.

هل io.github.theYahia/salutespeech-mcp مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.theYahia/salutespeech-mcp؟

ينشره theYahia. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.