# Yeelight IoT MCP Server

Подключает ИИ-клиент к облаку Yeelight Pro: находит дома, комнаты и устройства, читает состояние и выполняет сцены.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 10
- Автор: Yeelight
- Лицензия: Apache-2.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/Yeelight/yeelight-iot-mcp
- Обновлён: 2026-07-23
- HTML: https://affpapa.org/nevibecode/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`, менять ничего не нужно.

## Требования
- Удалённый сервер: `https://api.yeelight.com/apis/mcp_server/v1/mcp`

## Установка

### Claude Code (родная платформа)

**Командой платформы: удалённый сервер**
```bash
claude mcp add --transport http yeelight-iot-mcp-server https://api.yeelight.com/apis/mcp_server/v1/mcp
```

### Codex

**Командой платформы: удалённый сервер**
```bash
codex mcp add yeelight-iot-mcp-server --url https://api.yeelight.com/apis/mcp_server/v1/mcp
```

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "yeelight-iot-mcp-server": {
            "url": "https://api.yeelight.com/apis/mcp_server/v1/mcp"
        }
    }
}
```

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "yeelight-iot-mcp-server": {
            "type": "http",
            "url": "https://api.yeelight.com/apis/mcp_server/v1/mcp"
        }
    }
}
```

### Gemini CLI

**Командой платформы: удалённый сервер**
```bash
gemini mcp add -t http yeelight-iot-mcp-server https://api.yeelight.com/apis/mcp_server/v1/mcp
```

## Когда брать
- узнать, какие комнаты и устройства есть в доме Yeelight Pro
- посмотреть текущее состояние лампы перед командой
- включить свет в комнате через агента, не открывая приложение
- запустить сцену по подтверждённому плану
- собрать список групп и сцен с постраничной выдачей

## Примеры запросов агенту
- Покажи все комнаты и устройства в моём доме Yeelight
- Составь план: выключить свет в спальне, но пока не выполняй
- Запусти сцену «Вечер» в гостиной

## Похожие
- [Scrapling MCP Server](https://affpapa.org/nevibecode/mcp/scrapling-mcp-server.md) — MCP-сервер · ★ 89433
- [browser-use](https://affpapa.org/nevibecode/mcp/browser-use.md) — MCP-сервер · ★ 119160
- [AIHawk](https://affpapa.org/nevibecode/mcp/aihawk.md) — MCP-сервер · ★ 32221
- [Skyvern](https://affpapa.org/nevibecode/mcp/skyvern.md) — MCP-сервер · ★ 23263
- [SeleniumBase MCP](https://affpapa.org/nevibecode/mcp/seleniumbase-mcp.md) — MCP-сервер · ★ 13169
- [Inbox Zero](https://affpapa.org/nevibecode/mcp/inbox-zero.md) — MCP-сервер · ★ 12791

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md