yandex-speechkit-mcp

Name: yandex-speechkit-mcp
Author: theYahia

Local

github.com/theYahiaMedia & Design0Updated 10w ago

Repository

About yandex-speechkit-mcp

yandex-speechkit-mcp connects Yandex SpeechKit to MCP clients for speech recognition, speech synthesis, and voice discovery. It also provides higher-level transcription and synthesis tools.

Key features

01Transcribe audio to text
02Synthesize speech from text
03List voices by language
04Transcribe with clean-text output
05Synthesize with language-aware defaults

Use cases

01Convert an audio recording to text
02Generate audio from written text
03Find available voices for a language

MCP support

Exposes five Yandex SpeechKit tools to MCP clients, including core API operations and higher-level transcription and synthesis tools.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config

{
  "mcpServers": {
    "theyahia-yandex-speechkit": {
      "command": "npx",
      "args": [
        "-y",
        "@theyahia/yandex-speechkit-mcp"
      ],
      "env": {
        "YANDEX_API_KEY": "<YANDEX_API_KEY>"
      }
    }
  }
}

Run commandnpx -y @theyahia/yandex-speechkit-mcp

Environment variables to set

YANDEX_API_KEYSecretAPI key for the service

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages

npm@theyahia/yandex-speechkit-mcp1.0.0stdio

Tools

Saved tool list · updated 2w ago

Parameter	Type	Required	Description
lang	string	No	Recognition language (ru-RU, en-US, tr-TR)
format	string	No	Audio format (oggopus, lpcm)
audio_base64	string	Yes	Audio data in Base64 format

Details

From the project README

🗄 Репозиторий заархивирован

Разработка переехала в 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-mcp is 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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

Read the getting-started guide

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.