io.github.theYahia/yandex-speechkit-mcp
MCP server for Yandex SpeechKit API — speech recognition and synthesis.
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
@theyahia/yandex-speechkit-mcpclaude mcp add yandex-speechkit-mcp -e 'YANDEX_API_KEY=<your yandex_api_key>' -- npx -y @theyahia/yandex-speechkit-mcp@1.0.0
{
"mcpServers": {
"yandex-speechkit-mcp": {
"command": "npx",
"args": [
"-y",
"@theyahia/yandex-speechkit-mcp@1.0.0"
],
"env": {
"YANDEX_API_KEY": "<your yandex_api_key>"
}
}
}
}
Environment variables
YANDEX_API_KEYrequired secret API key for the service
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
Contents
🗄 Репозиторий заархивирован
Разработка переехала в theYahia/YaAll — сборку, где весь яндексовский слой лежит в одном месте: свои MCP-серверы, скиллы Claude Code и материалы официальных наборов Яндекса.
Актуальная версия того, что лежало здесь:
mcp/yandex-speechkit-mcp/Пакет в npm прежний —
@theyahia/yandex-speechkit-mcp, ставится и работает как раньше. Здесь больше ничего не обновляется. Задачи и pull request'ы — в YaAll.Archived — development moved to theYahia/YaAll, a single repository bundling the whole Yandex stack. The current version of this package now lives at
mcp/yandex-speechkit-mcp/. The npm package@theyahia/yandex-speechkit-mcpis unchanged. Please open issues and pull requests there.
Этот сервер входит в сборку theYahia/YaAll — весь яндексовский слой в одном репозитории: десять MCP-серверов, скиллы Claude Code под SEO и валидацию спроса, плюс материалы официальных серверов Яндекса. Здесь он живёт отдельно, там — рядом с остальными:
mcp/yandex-speechkit-mcp/Part of theYahia/YaAll — the whole Yandex stack in one repo.
@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
Frequently asked questions
What is io.github.theYahia/yandex-speechkit-mcp?
MCP server for Yandex SpeechKit API — speech recognition and synthesis.
How do I install io.github.theYahia/yandex-speechkit-mcp?
It runs on your machine. In Claude Code: claude mcp add yandex-speechkit-mcp -e 'YANDEX_API_KEY=<your yandex_api_key>' -- npx -y @theyahia/yandex-speechkit-mcp@1.0.0. For other clients, paste the JSON configuration from this page into their MCP settings.
Does io.github.theYahia/yandex-speechkit-mcp need an API key?
Yes. It expects YANDEX_API_KEY, which you set in its configuration.
Is io.github.theYahia/yandex-speechkit-mcp open source?
Yes. Its code is on GitHub under the MIT license.
Who maintains io.github.theYahia/yandex-speechkit-mcp?
It is published by theYahia. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.