Homebridge — MCP-сервер для Claude Code: обзор и установка
Управляет умным домом через Homebridge: переключает аксессуары, меняет конфигурацию, ищет сбои в логах и ставит плагины.
лицензия не указана ★ 12 обновлён 2026-10-24
claude mcp add --env HOMEBRIDGE_URL=<HOMEBRIDGE_URL> --env HOMEBRIDGE_TOKEN=<HOMEBRIDGE_TOKEN> --env HOMEBRIDGE_USERNAME=<HOMEBRIDGE_USERNAME> --env HOMEBRIDGE_PASSWORD=<HOMEBRIDGE_PASSWORD> --env HOMEBRIDGE_READ_ONLY=<HOMEBRIDGE_READ_ONLY> --transport stdio homebridge -- npx -y @mp-consulting/homebridge-ai-kitЧто делает Homebridge
Пакет связывает Homebridge с инструментами MCP через stdio или HTTP. Внутри доступно 43 инструмента: чтение и правка config.json с автоскрытием секретов, управление дочерними мостами, фильтрация логов регулярными выражениями и работа с плагинами.
Опасные действия защищены проверками. Для открытия умных замков или гаражных ворот сервер требует явного подтверждения. Массовые команды и изменение конфигурации поддерживают безопасный прогон dryRun.
Для запуска нужен доступ к экземпляру Homebridge 1.8+ или 2.x. В конфигурации клиента задаются переменные HOMEBRIDGE_URL, HOMEBRIDGE_TOKEN либо пара логина и пароля. Если нужно запретить любые изменения в умном доме, передайте флаг HOMEBRIDGE_READ_ONLY.
Какие задачи решает
- проверить ошибки в свежих логах Homebridge
- изменить параметры в
config.jsonбез утечки паролей - перезапустить упавший дочерний мост
- включить сценарий или сгруппировать устройства по комнатам
Примеры запросов агенту
- Найди в логах Homebridge ошибки с помощью промпта diagnose-logs
- Сделай dryRun для частичного обновления config.json
- Покажи состояние дочерних мостов через ресурс homebridge://status
Как установить Homebridge
Командой платформы
claude mcp add --env HOMEBRIDGE_URL=<HOMEBRIDGE_URL> --env HOMEBRIDGE_TOKEN=<HOMEBRIDGE_TOKEN> --env HOMEBRIDGE_USERNAME=<HOMEBRIDGE_USERNAME> --env HOMEBRIDGE_PASSWORD=<HOMEBRIDGE_PASSWORD> --env HOMEBRIDGE_READ_ONLY=<HOMEBRIDGE_READ_ONLY> --transport stdio homebridge -- npx -y @mp-consulting/homebridge-ai-kitВместо <…> подставьте свои значения
Командой платформы
codex mcp add homebridge --env HOMEBRIDGE_URL=<HOMEBRIDGE_URL> --env HOMEBRIDGE_TOKEN=<HOMEBRIDGE_TOKEN> --env HOMEBRIDGE_USERNAME=<HOMEBRIDGE_USERNAME> --env HOMEBRIDGE_PASSWORD=<HOMEBRIDGE_PASSWORD> --env HOMEBRIDGE_READ_ONLY=<HOMEBRIDGE_READ_ONLY> -- npx -y @mp-consulting/homebridge-ai-kitВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"homebridge": {
"command": "npx",
"args": [
"-y",
"@mp-consulting/homebridge-ai-kit"
],
"env": {
"HOMEBRIDGE_URL": "<HOMEBRIDGE_URL>",
"HOMEBRIDGE_TOKEN": "<HOMEBRIDGE_TOKEN>",
"HOMEBRIDGE_USERNAME": "<HOMEBRIDGE_USERNAME>",
"HOMEBRIDGE_PASSWORD": "<HOMEBRIDGE_PASSWORD>",
"HOMEBRIDGE_READ_ONLY": "<HOMEBRIDGE_READ_ONLY>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"homebridge": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@mp-consulting/homebridge-ai-kit"
],
"env": {
"HOMEBRIDGE_URL": "<HOMEBRIDGE_URL>",
"HOMEBRIDGE_TOKEN": "<HOMEBRIDGE_TOKEN>",
"HOMEBRIDGE_USERNAME": "<HOMEBRIDGE_USERNAME>",
"HOMEBRIDGE_PASSWORD": "<HOMEBRIDGE_PASSWORD>",
"HOMEBRIDGE_READ_ONLY": "<HOMEBRIDGE_READ_ONLY>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e HOMEBRIDGE_URL=<HOMEBRIDGE_URL> -e HOMEBRIDGE_TOKEN=<HOMEBRIDGE_TOKEN> -e HOMEBRIDGE_USERNAME=<HOMEBRIDGE_USERNAME> -e HOMEBRIDGE_PASSWORD=<HOMEBRIDGE_PASSWORD> -e HOMEBRIDGE_READ_ONLY=<HOMEBRIDGE_READ_ONLY> homebridge npx -y @mp-consulting/homebridge-ai-kitВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Homebridge
Как установить Homebridge в Claude Code?
Выполните команду `claude mcp add homebridge-ai-kit -e HOMEBRIDGE_URL=<HOMEBRIDGE_URL> -e HOMEBRIDGE_TOKEN=<HOMEBRIDGE_TOKEN> -e HOMEBRIDGE_PASSWORD=<HOMEBRIDGE_PASSWORD> -- npx -y @mp-consulting/homebridge-ai-kit`. Подставьте свои адрес и секреты.
Что делает этот MCP-сервер?
Он предоставляет 43 инструмента для взаимодействия с аксессуарами, аудита конфигурации и управления плагинами прямо в окне чата.
Можно ли запустить сервер только на чтение?
Да, для этого задайте переменную окружения HOMEBRIDGE_READ_ONLY. В этом режиме любые изменяющие операции блокируются.