homeassistant-mcp-server — скилл для Claude Code: обзор и запуск
Скилл homeassistant-mcp-server связывает ассистента с Home Assistant через MCP. Позволяет управлять светом, замками, климатом и шторами прямо из терминала или редактора.
лицензия не указана 207 установок ★ 9 обновлён 2026-10-09
npx skills add reason-machines/mcp-skills --skill homeassistant-mcp-server -a claude-codeЧто делает homeassistant-mcp-server
Сервер создан на Python и FastMCP. Он даёт доступ к 40 инструментам для управления умным домом: умными розетками, освещением, термостатами, замками, жалюзи, медиаплеерами и роботами-пылесосами. Чтобы не перегружать контекст модели десятками схем сразу, сервер использует систему обнаружения на базе поиска BM25: агент находит нужный инструмент по описанию и только потом запускает его.
Запросы выполняются асинхронно, а ответы о состоянии устройств кэшируются по TTL: 30 секунд для групповых списков и 10 секунд для одиночных сущностей. Это снижает нагрузку на контроллер умного дома.
Без переменных окружения HASS_HOST и долгоживущего токена HASS_TOKEN сервер не сможет подключиться к вашей системе Home Assistant.
Какие задачи решает
- переключать освещение, настраивать цвет и яркость из окна агента
- проверять текущие показания датчиков и статусы умных устройств
- запускать уборку роботом-пылесосом и выбирать скорость вентилятора
- менять уставки температуры и режимы работы климат-контроля
Примеры запросов агенту
- Включи торшер в гостиной на половинную яркость
- Проверь, заперта ли входная дверь и какая температура в детской
- Открой жалюзи в кабинете на 50 процентов
Как установить homeassistant-mcp-server
1Через Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill homeassistant-mcp-server -a claude-code2Вручную: положить файлы
~/.claude/skills/homeassistant-mcp-server/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/homeassistant-mcp-server/
1Через Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill homeassistant-mcp-server -a codex2Вручную: положить файлы
.agents/skills/homeassistant-mcp-server/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill homeassistant-mcp-server -a cursor2Вручную: положить файлы
.cursor/skills/homeassistant-mcp-server/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install reason-machines/mcp-skills skills/homeassistant-mcp-server2Вручную: положить файлы
.github/skills/homeassistant-mcp-server/SKILL.md1Через Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill homeassistant-mcp-server -a gemini-cli2Командой платформы
gemini skills install https://github.com/reason-machines/mcp-skills --path skills/homeassistant-mcp-serverВручную: положить файлы
.devin/skills/homeassistant-mcp-server/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill homeassistant-mcp-server -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о homeassistant-mcp-server
Как установить homeassistant-mcp-server в Claude Code?
Выполните команду npx skills add reason-machines/mcp-skills --skill homeassistant-mcp-server -a claude-code в терминале.
Какие данные нужны для подключения?
Требуется передать адрес сервера в переменной HASS_HOST и токен доступа в HASS_TOKEN. Токен создаётся в профиле пользователя Home Assistant.
Зачем серверу встроенный поиск через BM25?
Вместо передачи всех 40 инструментов в системный промпт сервер открывает 8 вспомогательных функций. Ассистент динамически находит и вызывает подходящий инструмент, сохраняя токены контекста.