homebox-mcp — MCP-сервер для Claude Code: установка
Подключает Homebox к ИИ-клиенту через MCP: можно искать вещи, добавлять их в инвентарь и проверять гарантии обычными фразами.
claude mcp add --env HOMEBOX_URL=<HOMEBOX_URL> --env HOMEBOX_TOKEN=<HOMEBOX_TOKEN> --env HOMEBOX_ALIAS_FIELD=<HOMEBOX_ALIAS_FIELD> --env HOMEBOX_LABEL_DIR=<HOMEBOX_LABEL_DIR> --transport stdio homebox-mcp -- uvx homebox-mcpЧто делает homebox-mcp
homebox-mcp даёт MCP-клиенту доступ к инвентарю Homebox через REST API. Сервер ищет предметы и теги, показывает дерево мест хранения, содержимое вложенных зон и сроки гарантий. Можно создавать вещи и локации, импортировать CSV, искать товары по UPC/EAN, работать с вложениями и печатать QR-метки для контейнеров и полок.
Для чтения принимаются нечёткие идентификаторы, а операции изменения требуют точного имени, assetId или значения поля-алиаса. Дублирующиеся локации можно различать путём вроде Garage/Shelf 1. Запуск через uvx использует переменные HOMEBOX_URL и HOMEBOX_TOKEN; для дополнительных настроек есть HOMEBOX_ALIAS_FIELD и HOMEBOX_LABEL_DIR.
Нужен Homebox 0.26 или новее и API-ключ из раздела Profile → API Keys. Экземпляры старше 0.26 используют другой API и отклоняются при первом вызове инструмента, поэтому версия Homebox здесь критична.
Какие задачи решает
- искать вещи по имени, тегу или идентификатору
- проверять сроки окончания гарантий
- добавлять предметы вместе с тегами и данными покупки
- импортировать инвентарь из CSV
- разбирать содержимое локаций и вложенных зон
Примеры запросов агенту
- Найди в Homebox мой ударный шуруповёрт и покажи его локацию.
- Добавь в инвентарь дрель в
Garage/Shelf 1, укажи производителя и модель. - Покажи предметы, чьи гарантии истекают после сегодняшней даты.
Как установить homebox-mcp
Командой платформы
claude mcp add --env HOMEBOX_URL=<HOMEBOX_URL> --env HOMEBOX_TOKEN=<HOMEBOX_TOKEN> --env HOMEBOX_ALIAS_FIELD=<HOMEBOX_ALIAS_FIELD> --env HOMEBOX_LABEL_DIR=<HOMEBOX_LABEL_DIR> --transport stdio homebox-mcp -- uvx homebox-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from homebox-mcp <команда>
Командой платформы
codex mcp add homebox-mcp --env HOMEBOX_URL=<HOMEBOX_URL> --env HOMEBOX_TOKEN=<HOMEBOX_TOKEN> --env HOMEBOX_ALIAS_FIELD=<HOMEBOX_ALIAS_FIELD> --env HOMEBOX_LABEL_DIR=<HOMEBOX_LABEL_DIR> -- uvx homebox-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from homebox-mcp <команда>
Файл настроек
{
"mcpServers": {
"homebox-mcp": {
"command": "uvx",
"args": [
"homebox-mcp"
],
"env": {
"HOMEBOX_URL": "<HOMEBOX_URL>",
"HOMEBOX_TOKEN": "<HOMEBOX_TOKEN>",
"HOMEBOX_ALIAS_FIELD": "<HOMEBOX_ALIAS_FIELD>",
"HOMEBOX_LABEL_DIR": "<HOMEBOX_LABEL_DIR>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from homebox-mcp <команда>
Файл настроек
{
"servers": {
"homebox-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"homebox-mcp"
],
"env": {
"HOMEBOX_URL": "<HOMEBOX_URL>",
"HOMEBOX_TOKEN": "<HOMEBOX_TOKEN>",
"HOMEBOX_ALIAS_FIELD": "<HOMEBOX_ALIAS_FIELD>",
"HOMEBOX_LABEL_DIR": "<HOMEBOX_LABEL_DIR>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from homebox-mcp <команда>
Командой платформы
gemini mcp add -e HOMEBOX_URL=<HOMEBOX_URL> -e HOMEBOX_TOKEN=<HOMEBOX_TOKEN> -e HOMEBOX_ALIAS_FIELD=<HOMEBOX_ALIAS_FIELD> -e HOMEBOX_LABEL_DIR=<HOMEBOX_LABEL_DIR> homebox-mcp uvx homebox-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from homebox-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о homebox-mcp
Как установить homebox-mcp в Claude Code?
Выполните claude mcp add homebox-mcp -e HOMEBOX_URL=<HOMEBOX_URL> -e HOMEBOX_TOKEN=<HOMEBOX_TOKEN> -- uvx homebox-mcp.
Что делает homebox-mcp?
Он связывает MCP-клиент с Homebox и позволяет искать, создавать и уточнять записи инвентаря обычными запросами. Сервер также работает с локациями, гарантиями, тегами, вложениями и QR-метками.
Какая версия Homebox нужна для работы?
Требуется Homebox 0.26 или новее и API-ключ из Profile → API Keys. Старые версии используют другой API и отклоняются при первом вызове инструмента.
