Yeelight IoT MCP Server — MCP-сервер для Claude Code
Подключает ИИ-клиент к облаку Yeelight Pro: находит дома, комнаты и устройства, читает состояние и выполняет сцены.
claude mcp add --transport http yeelight-iot-mcp-server https://api.yeelight.com/apis/mcp_server/v1/mcpЧто делает Yeelight IoT MCP Server
Сервер даёт восемь инструментов: обход топологии (дома, зоны, комнаты, устройства, группы, сцены), чтение текущих возможностей, подготовка безопасного управления и запуск подтверждённых команд. Списки отдаются с курсорной пагинацией. Управление устройствами и запуск сцен по умолчанию идут в режиме dry-run: сначала агент показывает план, и только после явного подтверждения действие выполняется.
Работает по Streamable HTTP. Есть официальный хост https://api.yeelight.com/apis/mcp_server/v1/mcp и вариант с развёртыванием из исходников. Для локального запуска нужны Python 3.10 или новее и uv; локальная копия всё равно ходит в облачные API Yeelight, офлайн-шлюзом она не становится. Каждому запросу нужен заголовок Authorization с токеном Yeelight — без него сервер ничего не отдаст, даже если он слушает 127.0.0.1. Регион и House ID необязательны: без них регион берётся из JWT, а дом выбирается первый в регионе.
Токен можно получить через yeelight-home setup, который показывает QR-код для сканирования в приложении Yeelight Pro. Это же развёртывание ставит рядом Metadata MCP — если интеграция уже завязана на control_node или execute_scene, менять ничего не нужно.
Какие задачи решает
- узнать, какие комнаты и устройства есть в доме Yeelight Pro
- посмотреть текущее состояние лампы перед командой
- включить свет в комнате через агента, не открывая приложение
- запустить сцену по подтверждённому плану
- собрать список групп и сцен с постраничной выдачей
Примеры запросов агенту
- Покажи все комнаты и устройства в моём доме Yeelight
- Составь план: выключить свет в спальне, но пока не выполняй
- Запусти сцену «Вечер» в гостиной
Как установить Yeelight IoT MCP Server
Командой платформы: удалённый сервер
claude mcp add --transport http yeelight-iot-mcp-server https://api.yeelight.com/apis/mcp_server/v1/mcpКомандой платформы: удалённый сервер
codex mcp add yeelight-iot-mcp-server --url https://api.yeelight.com/apis/mcp_server/v1/mcpФайл настроек
{
"mcpServers": {
"yeelight-iot-mcp-server": {
"url": "https://api.yeelight.com/apis/mcp_server/v1/mcp"
}
}
}Файл настроек
{
"servers": {
"yeelight-iot-mcp-server": {
"type": "http",
"url": "https://api.yeelight.com/apis/mcp_server/v1/mcp"
}
}
}Командой платформы: удалённый сервер
gemini mcp add -t http yeelight-iot-mcp-server https://api.yeelight.com/apis/mcp_server/v1/mcpПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Yeelight IoT MCP Server
Как установить Yeelight IoT MCP Server в Claude Code?
Одной командой: claude mcp add --transport http yeelight-iot-mcp-server https://api.yeelight.com/apis/mcp_server/v1/mcp. После правки конфигурации перезапустите MCP-клиент.
Что делает Yeelight IoT MCP Server?
Даёт агенту доступ к топологии умного дома и живому состоянию устройств, а также инструменты control_node и execute_scene для управления светом и сценами.
Что нужно для работы сервера?
Токен авторизации Yeelight в заголовке Authorization — без него запросы не проходят. Для локального развёртывания нужны Python 3.10 или новее и uv.
