salutespeech-mcp

SaluteSpeech MCP — 面向 AI 助手的俄语语音识别与合成

如果你想把会议通话或语音消息转录成文本、用 Sber 的声音朗读文本，或在不搭建自有后端的情况下将俄语语音转文本接入 Claude，那么这就是你要找的工具。基于 Sber SaluteSpeech API 的 5 个工具：语音识别（STT）和语音合成（TTS）。

这是 @theYahia 的 WWmcp 系列（46 个服务）的一部分。

安装

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	字符串 client_id:client_secret 的 Base64 编码
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 MB / 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

Sber 端点使用 Russian Trusted Root CA（俄罗斯数字发展部国家认证中心），而 Node.js 的默认受信任根证书存储中没有该证书，因此首次 OAuth 请求会失败，除非你先添加该证书。

解决方案：从 gosuslugi.ru/crt 下载根证书（russian_trusted_root_ca_pem.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