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