homebutler — MCP-сервер для Claude Code: что менялось на сервере
Помнит, как выглядел ваш сервер в прошлый раз, и показывает, что с тех пор изменилось: контейнеры, порты, диски, бэкапы.
claude mcp add homebutler -- npx -y homebutlerЧто делает homebutler
Один бинарник на Go, который снимает снимок состояния homelab-сервера и сравнивает его с предыдущим. Вы получаете короткую сводку: что живо сейчас, какие есть предупреждения, что сдвинулось с прошлого прогона и какими командами это проверить. Снимки лежат в ~/.homebutler/reports/snapshots/, старые удаляются автоматически, лимит можно задать флагом --keep, а --no-save покажет отчёт без записи.
Смысл в том, что одинаковое число контейнеров до и после ничего не доказывает. Если контейнер пересоздали под тем же именем, счётчики совпадут, а внутри уже другое. Поэтому в отчёте у каждой строки есть тип изменения (gone, new, replaced, image, state, port, disk, skipped), и тот же тип уходит в --json, так что агент разбирает его полем, а не текстом.
Агенту отдаётся узкий интерфейс к серверу вместо полного SSH-доступа. Ему нужен сам бинарник на наблюдаемой машине: без него сравнивать нечего. Демона и базы данных нет.
Какие задачи решает
- узнать, какие контейнеры пересоздали под тем же именем
- найти, какой процесс занял освободившийся порт
- получить сводку состояния сервера без графиков и дашбордов
- проверить, что изменилось после
docker compose up -d - отдать ассистенту состояние сервера, не давая ему шелл
Примеры запросов агенту
- Сделай отчёт по серверу и покажи, что поменялось с прошлого снимка
- Что за процесс теперь слушает порт 8080?
- Сними снимок и оставь только последние 7 отчётов
Как установить homebutler
Командой платформы
claude mcp add homebutler -- npx -y homebutlerКомандой платформы
codex mcp add homebutler -- npx -y homebutlerФайл настроек
{
"mcpServers": {
"homebutler": {
"command": "npx",
"args": [
"-y",
"homebutler"
]
}
}
}Файл настроек
{
"servers": {
"homebutler": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"homebutler"
]
}
}
}Командой платформы
gemini mcp add homebutler npx -y homebutlerПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о homebutler
Как установить homebutler в Claude Code?
Одной командой: claude mcp add homebutler -- npx -y homebutler.
Что делает homebutler?
Сравнивает текущее состояние сервера с прошлым снимком и перечисляет изменения: контейнеры, образы, состояния, порты, диски. Вместо графа «как сейчас» вы видите, что сдвинулось и требует внимания.
Что означает тип изменения skipped?
Сравнение не удалось, например Docker не работал во время одного из снимков. Сервер честно говорит, что не может подтвердить отсутствие изменений, вместо ложного «всё в порядке».
