# HomeLab Monitor

Передаёт ИИ-ассистенту телеметрию домашнего сервера: статус Docker-контейнеров, метрики GPU и энергопотребление. Работает только на чтение.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 225
- Автор: SikamikanikoBG
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/SikamikanikoBG/homelab-monitor
- Обновлён: 2026-10-24
- HTML: https://affpapa.org/nevibecode/mcp/homelab-monitor

## Что делает

Сервер связывает ИИ-ассистента с локальным дашбордом домашней лаборатории через Docker-контейнер. Он отдаёт языковой модели данные о хостах, дисках и службах. Информация собирается по SSH. Ассистент видит нагрузку на видеокарты NVIDIA, AMD или Intel, включая частоты, нагрев и причины троттлинга из `nvidia-smi`.

Мониторинг рассчитывает затраты электричества на каждый контейнер и процесс через RAPL и драйверы GPU. Система замеряет скорость Ollama и переполнение видеопамяти в RAM. Сервер работает строго в режиме чтения. Из-за этого агент не сможет сам перезагрузить упавший сервис. Для запуска контейнера нужны переменные `HOMELAB_MONITOR_URL` и `MCP_TRANSPORT`.

## Требования
- Нужно: Docker
- Переменные окружения: `HOMELAB_MONITOR_URL`, `MCP_TRANSPORT` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add --env HOMELAB_MONITOR_URL=<HOMELAB_MONITOR_URL> --env MCP_TRANSPORT=<MCP_TRANSPORT> --transport stdio homelab-monitor -- docker run -i --rm -e HOMELAB_MONITOR_URL -e MCP_TRANSPORT docker.io/sikamikaniko123/homelab-monitor:0.14.2
```
Вместо <…> подставьте свои значения

### Codex

**Командой платформы**
```bash
codex mcp add homelab-monitor --env HOMELAB_MONITOR_URL=<HOMELAB_MONITOR_URL> --env MCP_TRANSPORT=<MCP_TRANSPORT> -- docker run -i --rm -e HOMELAB_MONITOR_URL -e MCP_TRANSPORT docker.io/sikamikaniko123/homelab-monitor:0.14.2
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "homelab-monitor": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "-e",
                "HOMELAB_MONITOR_URL",
                "-e",
                "MCP_TRANSPORT",
                "docker.io/sikamikaniko123/homelab-monitor:0.14.2"
            ],
            "env": {
                "HOMELAB_MONITOR_URL": "<HOMELAB_MONITOR_URL>",
                "MCP_TRANSPORT": "<MCP_TRANSPORT>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "homelab-monitor": {
            "type": "stdio",
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "-e",
                "HOMELAB_MONITOR_URL",
                "-e",
                "MCP_TRANSPORT",
                "docker.io/sikamikaniko123/homelab-monitor:0.14.2"
            ],
            "env": {
                "HOMELAB_MONITOR_URL": "<HOMELAB_MONITOR_URL>",
                "MCP_TRANSPORT": "<MCP_TRANSPORT>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e HOMELAB_MONITOR_URL=<HOMELAB_MONITOR_URL> -e MCP_TRANSPORT=<MCP_TRANSPORT> homelab-monitor docker run -i --rm -e HOMELAB_MONITOR_URL -e MCP_TRANSPORT docker.io/sikamikaniko123/homelab-monitor:0.14.2
```
Вместо <…> подставьте свои значения

## Когда брать
- проверить потребление VRAM и температуру видеокарт на хостах
- узнать расход электроэнергии и стоимость работы отдельных контейнеров
- выяснить причину троттлинга GPU при обучении нейросетей
- оценить скорость генерации токенов в локальной модели Ollama
- проконтролировать свободное место на дисках удалённых машин

## Примеры запросов агенту
- Покажи температуру и частоту памяти на всех видеокартах сервера.
- Сколько электричества потребил контейнер с базой данных за сегодня?
- Проверь, хватает ли видеопамяти для запуска модели в Ollama.

## Похожие
- [GitHub](https://affpapa.org/nevibecode/mcp/github.md) — MCP-сервер · ★ 33918
- [Netdata](https://affpapa.org/nevibecode/mcp/netdata.md) — MCP-сервер · ★ 81115
- [Oh My Posh Validator](https://affpapa.org/nevibecode/mcp/oh-my-posh-validator.md) — MCP-сервер · ★ 23643
- [Keploy](https://affpapa.org/nevibecode/mcp/keploy.md) — MCP-сервер · ★ 18727
- [Coder](https://affpapa.org/nevibecode/mcp/coder.md) — MCP-сервер · ★ 17160
- [mcp](https://affpapa.org/nevibecode/mcp/kubeshark-mcp.md) — MCP-сервер · ★ 12109

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md