@theyahia/yandex-speechkit-mcp
MCP server for Yandex SpeechKit API — speech recognition, synthesis, and voice listing. 5 tools.
Part of the Russian API MCP series by @theYahia.
Installation
Claude Desktop
{
"mcpServers": {
"yandex-speechkit": {
"command": "npx",
"args": ["-y", "@theyahia/yandex-speechkit-mcp"],
"env": {
"YANDEX_SPEECHKIT_API_KEY": "your-api-key",
"FOLDER_ID": "your-folder-id"
}
}
}
}
Claude Code
claude mcp add yandex-speechkit \
-e YANDEX_SPEECHKIT_API_KEY=your-api-key \
-e FOLDER_ID=your-folder-id \
-- npx -y @theyahia/yandex-speechkit-mcp
Streamable HTTP (remote / Docker)
YANDEX_SPEECHKIT_API_KEY=... FOLDER_ID=... npx @theyahia/yandex-speechkit-mcp --http
# Listens on :8080/mcp (override with PORT env var)
Smithery
Deploy via smithery.ai — config in smithery.yaml.
Authentication
| Variable | Description |
|---|---|
YANDEX_SPEECHKIT_API_KEY | Yandex Cloud API key (preferred) |
YANDEX_API_KEY | Legacy alias (still works) |
IAM_TOKEN | Short-lived IAM token (alternative to API key) |
FOLDER_ID | Yandex Cloud folder ID (required) |
YANDEX_FOLDER_ID | Legacy alias for FOLDER_ID |
Get credentials at Yandex Cloud Console.
Tools (5)
| Tool | Type | Description |
|---|---|---|
recognize | Core | Speech recognition (STT) — Base64 audio to text |
synthesize | Core | Speech synthesis (TTS) — text to Base64 audio |
list_voices | Core | List available TTS voices, filter by language |
skill_transcribe | Skill | High-level transcription — returns clean text |
skill_synthesize | Skill | High-level synthesis — smart defaults, auto-detects language from voice |
Examples
Transcribe this audio file
Synthesize "Hello, how are you?" with voice filipp
What voices are available in Russian?
Speak this text using the alena voice
Development
npm install
npm run build
npm test
npm run dev # stdio mode
License
MIT