ha-mcp — MCP-сервер для Claude Code: управление Home Assistant
Сервер связывает ИИ-ассистента с Home Assistant: через запросы можно управлять устройствами, проверять их состояние и запускать сервисы. Пригодится для работы с умным домом из чата.
claude mcp add ha-mcp -- uvx ha-mcpЧто делает ha-mcp
ha-mcp даёт ассистенту доступ к Home Assistant через MCP. Можно попросить его изменить состояние устройства, узнать текущие значения, вызвать сервис или управлять автоматизациями. Сервер также включает панель HA-MCP в боковой панели Home Assistant для администратора.
Для Claude Code сервер запускается командой claude mcp add ha-mcp -- uvx ha-mcp. В описанном способе используется uvx; для подключения через компонент Home Assistant понадобится токен администратора, а способ доступа клиента настраивается отдельно. Выбирайте один вариант запуска: параллельная работа разных установок ha-mcp может привести к конфликтам.
Какие задачи решает
- управлять устройствами Home Assistant через запрос к ассистенту
- узнать состояние устройства без ручного поиска в интерфейсе
- вызвать сервис Home Assistant из чата
- попросить ассистента изменить автоматизацию
Примеры запросов агенту
- Выключи свет в гостиной через Home Assistant.
- Покажи текущее состояние датчиков температуры.
- Запусти сервис Home Assistant для перезагрузки роутера.
Как установить ha-mcp
Командой платформы
claude mcp add ha-mcp -- uvx ha-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from ha-mcp <команда>
Командой платформы
codex mcp add ha-mcp -- uvx ha-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from ha-mcp <команда>
Файл настроек
{
"mcpServers": {
"ha-mcp": {
"command": "uvx",
"args": [
"ha-mcp"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from ha-mcp <команда>
Файл настроек
{
"servers": {
"ha-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"ha-mcp"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from ha-mcp <команда>
Командой платформы
gemini mcp add ha-mcp uvx ha-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from ha-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о ha-mcp
Как установить ha-mcp в Claude Code?
Выполните claude mcp add ha-mcp -- uvx ha-mcp, чтобы добавить сервер MCP с именем ha-mcp.
Что делает ha-mcp?
Он подключает ИИ-ассистента к Home Assistant для управления устройствами, просмотра состояний и вызова сервисов. Через него также можно работать с автоматизациями.
Можно ли одновременно запустить несколько установок ha-mcp?
В описании рекомендуется использовать только один способ запуска. Не запускайте компонент Home Assistant вместе с другой установкой ha-mcp.
