HomeLab Monitor MCP
Панель домашней лаборатории с MCP-сервером только для чтения: хосты, Docker, GPU, память видеокарт и службы
- 236 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Панель получает доступ к хосту: сокет Docker с записью, D-Bus и SSH-ключи к другим машинам, а кнопки управления включены по умолчанию
- MCP-порт 9810 раскрывает состояние всего парка каждому, кто до него дотянется
Установка
- Работает в
Ручная установка
claude mcp add --transport http homelab http://YOUR-HUB:9810/mcpАдрес хаба вашей панели; MCP включен по умолчанию.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Панель получает доступ к хосту: сокет Docker с записью, D-Bus и SSH-ключи к другим машинам, а кнопки управления включены по умолчанию
- MCP-порт 9810 раскрывает состояние всего парка каждому, кто до него дотянется
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
HomeLab Monitor собирает в одной странице все машины и видеокарты домашней лаборатории и отвечает на вопросы: что делает GPU и какая модель держит видеопамять, сколько стоит работа, какой контейнер ест оперативную память, что занимает диски и что лежит. Он работает в одном контейнере, опрашивает хосты по SSH на Linux, Raspberry Pi и даже Windows, ничего не ставя на сами машины. Встроенный MCP-сервер только для чтения слушает порт 9810: любой клиент (Claude, Claude Code, агенты на локальных моделях Ollama) видит хосты, контейнеры, видеокарты и диски. Инструментов записи в нем нет, поэтому агент смотрит, но не трогает парк. Подключение одной строкой: `claude mcp add --transport http homelab http://YOUR-HUB:9810/mcp`, а отключают переменной `ENABLE_MCP=0`. Есть и собственный ИИ-агент в панели, который отвечает по тем же инструментам, плюс лаборатория бенчмарков для локальных моделей.
Для кого. Владельцам домашних серверов с GPU и локальными моделями, которым нужен один обзор парка и агент, отвечающий на вопросы о нем по данным панели.
Подходит, если
- Видеокарта всегда занята, и нужно понять, какая модель Ollama держит видеопамять и сколько это стоит по электричеству
- Диск на одном из серверов заполнился, и агент показывает, какие каталоги его занимают
- Контейнер съел память, и агент сопоставляет оперативную память и видеопамять по строкам
- Нужна проверка, что все хосты парка живы и сервисы systemd работают
Не подходит, если
- Нужно перезапускать контейнеры и менять сервисы через агента: у MCP-сервера нет инструментов записи
- Парк в облаке или корпоративная сеть с жесткими правилами: сервис рассчитан на домашнюю лабораторию
- Нужен учет на тысячах узлов: решение ориентировано на парк из нескольких машин
Пример запроса к агенту
Покажи, какая модель сейчас держит видеопамять на каждой видеокарте, сколько она тратит электричества и какие контейнеры используют больше всего оперативной памятиMCP
- Транспорт
- http
- Авторизация
- не нужна
Переменные окружения
MCP_PORT- Порт встроенного MCP-сервера, по умолчанию 9810
ENABLE_MCP- Значение 0 выключает MCP-сервер
Ограничения
Панель выполняется с доступом к хосту: монтируются корень хоста только для чтения, а также сокет Docker с записью и D-Bus. Кнопки запуска, остановки и перезапуска контейнеров и служб и самообновление включены по умолчанию, их отключают `ENABLE_CONTROLS=0` и `ALLOW_SELF_UPDATE=0` или прокси сокета Docker. Сам MCP-сервер только читает, но доступ к его порту 9810 открывает всю картину парка, поэтому порт не стоит выставлять в интернет. Для опроса удаленных машин нужны ключ SSH и Python 3 на них (PowerShell на Windows). GPU-панели оживают только при наличии видеокарты.
Как отключить. Выключите MCP переменной `ENABLE_MCP=0` и удалите сервер из клиента (`claude mcp remove homelab`). Панель останавливается командой `docker compose down`, а ключи SSH снимают с удаленных машин.
Частые вопросы
Как запустить HomeLab Monitor?
Скачайте `docker-compose.yml` из репозитория (`curl -fsSLO https://raw.githubusercontent.com/SikamikanikoBG/homelab-monitor/main/docker-compose.yml`) и выполните `docker compose up -d`. Панель откроется на порту 9800, GPU не обязателен.
Какой адрес у MCP-сервера?
`http://<хост>:9810/mcp`. Порт задает `MCP_PORT`, а выключает сервер `ENABLE_MCP=0`.
Может ли агент через MCP остановить контейнер?
Нет, сервер только читает и инструментов записи не содержит. Кнопки управления в самой панели включаются отдельно и не относятся к MCP.
Как панель опрашивает другие машины?
По SSH: вставьте автоматически созданный ключ хаба на каждую машину, и хаб начнет опрос. Агентов ставить не надо: нужны SSH и Python 3, на Windows PowerShell.
Что умеет лаборатория бенчмарков?
Загружает каждую вашу локальную модель Ollama и прогоняет ряд размеров контекста на ваших картах, записывая токены в секунду, время загрузки и то, сколько ушло из видеопамяти в оперативную.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыСамохостящийся хаб для домашней лаборатории со встроенным MCP-сервером: у агента 32 инструмента с правами по ключам API
CLI на Go сравнивает сервер с прошлым снимком, сообщает только значимые перемены и отдает их агенту через MCP
HomelabHero за одну команду превращает свежий LXC в центр управления домашней лабораторией с Claude Code и брокером доступов.
MCP-сервер мониторинга maintenant: агент читает логи контейнеров, историю проверок и алерты, но не трогает контейнеры
Веб-дашборд в одном Docker-контейнере для мониторинга и управления флотом MCP-серверов 1С: статус, прогресс индексации, VRAM и лицензии
MCP-сервер для диагностики Linux: ИИ-клиент читает службы, журналы и сеть локальных и удаленных систем без права записи
Коротко о README
Текст обещает ответить на вопросы по домашней лаборатории: одна страница на каждую машину и GPU и ИИ-агент, который читает все и чинит только по вашей команде. Дальше идут быстрый старт через Compose, возможности панели, таблица переменных, раздел про MCP для своих клиентов и предупреждения о доступе к хосту.