Yandex Station MCP

Отдельный MCP-сервер для управления Яндекс Станцией / колонкой с Алисой: музыка, радио, громкость, пауза, следующий трек, TTS и текстовые команды Алисе.

Код использует подходы из проекта AlexxIT/YandexStation под лицензией MIT. Это неофициальный API Яндекса, поэтому он может измениться.

Что умеет

получить список колонок аккаунта;
отправить Алисе текстовую команду: включи радио Европа плюс;
произнести текст через колонку;
произнести уведомление с заданной громкостью;
поставить громкость;
play / pause / next / previous;
stop;
быстрые команды для музыки и радио.
таймеры, будильники, напоминания;
погода и новости;
список и запуск сценариев Яндекс Умного дома;
диагностика подключения без вывода токенов.

Ограничения

Это не официальный API Яндекса.
Нужна авторизация Яндекса через QR.
Токены хранятся только локально и не должны попадать в GitHub.
Для облачного управления интеграция создает/обновляет служебный сценарий в аккаунте Яндекса с именем вида ХА <device_id>.
Облачный режим не всегда дает точное состояние воспроизведения. Он хорошо отправляет команды, но не всегда знает, что сейчас играет.

Установка

git clone https://github.com/yasg1988/yandex-station-mcp.git
cd yandex-station-mcp
python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -r requirements.txt

Авторизация через QR

python yandex_station_mcp\auth_qr.py

Скрипт покажет ссылку. Откройте ее в браузере, войдите в Яндекс и подтвердите вход. После успешного входа будет создан локальный файл:

yandex_station_mcp/yandex_tokens.json

Не публикуйте этот файл.

Проверка списка станций

python yandex_station_mcp\cli.py list

Проверка команды

python yandex_station_mcp\cli.py command "включи радио Европа плюс"

Подключение MCP в Codex

Пример C:\Users\<USER>\.codex\config.toml:

[mcp_servers.yandex-station]
command = "python"
args = ["D:\\path\\to\\yandex-station-mcp\\yandex_station_mcp\\server.py"]
startup_timeout_ms = 20000

[mcp_servers.yandex-station.env]
YANDEX_TOKEN_FILE = "D:\\path\\to\\yandex-station-mcp\\yandex_station_mcp\\yandex_tokens.json"
# YANDEX_STATION_ID = "опционально"
# YANDEX_STATION_NAME = "опционально"

Если колонок несколько, можно задать колонку по умолчанию через YANDEX_STATION_ID или YANDEX_STATION_NAME. Если переменные не заданы, используется первая доступная колонка аккаунта.

MCP tools

station_list
station_status
station_default
station_diagnostics
station_command
station_say
station_notify
station_volume
station_play
station_pause
station_stop
station_next
station_previous
station_radio
station_music
station_timer
station_alarm
station_reminder
station_weather
station_news
station_scenario_list
station_scenario_run

CLI команды

python yandex_station_mcp\cli.py list
python yandex_station_mcp\cli.py diagnostics
python yandex_station_mcp\cli.py notify "Задача завершена" --volume 0.4
python yandex_station_mcp\cli.py stop
python yandex_station_mcp\cli.py timer 10 --text "проверить духовку"
python yandex_station_mcp\cli.py alarm "7:30"
python yandex_station_mcp\cli.py reminder "купить хлеб" "завтра в 9"
python yandex_station_mcp\cli.py weather
python yandex_station_mcp\cli.py news
python yandex_station_mcp\cli.py scenarios
python yandex_station_mcp\cli.py scenario "Название сценария"

Примеры фраз для Codex

включи радио Европа плюс на колонке
сделай Алису потише
поставь громкость Алисы 30 процентов
попроси Алису включить мою волну
скажи через колонку: ужин готов
уведомь через колонку: задача завершена
поставь таймер на 10 минут
поставь будильник на 7:30
напомни завтра в 9 купить хлеб
запусти сценарий Вечер

Уведомление Codex через колонку после завершения задачи

В репозитории есть готовый hook-скрипт:

hooks/codex_stop_notify.py

Он срабатывает на событии Codex CLI Stop, ставит громкость 0.4 и произносит:

Сообщение от Кодекс: я закончил задачу

Пример блока для C:\Users\<USER>\.codex\config.toml:

[[hooks.Stop]]

[[hooks.Stop.hooks]]
type = "command"
command = 'python "D:\path\to\yandex-station-mcp\hooks\codex_stop_notify.py"'
timeout = 30
statusMessage = "Уведомляю через Яндекс Станцию"

После добавления hook откройте в Codex CLI команду /hooks и подтвердите доверие к hook-команде. Это нужно один раз после добавления или изменения hook.

Чтобы временно отключить уведомление без удаления hook, запустите Codex с переменной окружения:

$env:CODEX_YANDEX_NOTIFY_DISABLED = "1"
codex

MCP Servers