LabTether MCP
Самохостящийся хаб для домашней лаборатории со встроенным MCP-сервером: у агента 32 инструмента с правами по ключам API
- 126 ★ репозитория
- Последний коммит
- Apache-2.0
Широкий доступ
Почему такой уровень
- Через хаб можно открыть терминал, удаленный рабочий стол, перемещать файлы, перезапускать службы и обновлять пакеты на машинах лаборатории
- Ключ API для MCP дает агенту доступ в пределах заданных областей, поэтому с чтения стоит начинать
- Хаб хранит ключи подключенных систем и журнал, и его порты нужно держать закрытыми от внешней сети
Установка
- Работает в
Ручная установка
LABTETHER_VERSION=vX.Y.Z bash install-labtether.shСначала скачайте скрипт с https://labtether.com/install.sh, прочтите его и подставьте версию из последнего релиза. Нужен Docker с Compose 2.33.1+.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Через хаб можно открыть терминал, удаленный рабочий стол, перемещать файлы, перезапускать службы и обновлять пакеты на машинах лаборатории
- Ключ API для MCP дает агенту доступ в пределах заданных областей, поэтому с чтения стоит начинать
- Хаб хранит ключи подключенных систем и журнал, и его порты нужно держать закрытыми от внешней сети
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
LabTether собирает машины, виртуалки и контейнеры домашней лаборатории в один хаб, который работает на вашем оборудовании и запускается через Docker `Compose`. На одном экране видны узлы с загрузкой процессора, памяти, диска, сети и температуры, а рядом их виртуальные машины и контейнеры, оповещения и журналы. С любой машины можно открыть терминал или удаленный рабочий стол по `VNC`, `RDP`, `SPICE` или `WebRTC`. Агентам узлов SSH-ключи не нужны. Хаб подключается к Proxmox VE, Proxmox Backup Server, `TrueNAS`, `Portainer` и Home Assistant по ключу API, ничего не устанавливая на этих системах. Для хостов Docker нужен агент. В хабе есть правила оповещений с маршрутами и окнами тишины, инциденты, карта зависимостей, перемещение файлов между машинами, перезапуск служб, поиск по журналам, обновление пакетов с пробным прогоном и сохраненные команды по расписанию. Встроенный MCP-сервер открывает агенту 32 инструмента для лаборатории. Адрес подключения для Claude, Cursor или другого MCP-клиента: `https://your-hub:8443/mcp`. У каждого ключа API свои права, поэтому агент затрагивает только то, что вы разрешили. Дополнительные входы: CLI, REST API с OpenAPI-справочником, интеграция Home Assistant. Защита включает HTTPS с первого запуска, `2FA`, единый вход `OIDC`, роли владельца, администратора, оператора и наблюдателя и журнал аудита.
Для кого. Владельцам домашних лабораторий на Proxmox, `TrueNAS` и Docker, которые хотят спрашивать у Claude или Cursor о состоянии машин и поручать им рутину.
Подходит, если
- Ночью сломался диск, и вместо пяти вкладок хочется спросить агента, что случилось на узлах и в журналах
- Рутину вроде перезапуска службы или обновления пакетов с пробным прогоном поручают агенту с узкими правами ключа
- Нужна общая картина: что упадет вместе с узлом, если его перезагрузить, по карте зависимостей
- Данные лаборатории должны оставаться в вашей сети, а удаленный доступ идет через `Tailscale` без открытых портов
- Правила для агента удобно задавать правами ключа API: чтение для одного ключа, действия для другого
Не подходит, если
- Нужно управлять одним Proxmox без хаба: для этого есть отдельные MCP-серверы под Proxmox
- Лаборатория на FreeBSD: платформа в плане, пока такой хост добавляют как ручное устройство по SSH
- Требуется нативное приложение для iPhone и iPad: оно только готовится
- Нужны облачные сервисы без своего оборудования: хаб рассчитан на самостоятельный запуск
Пример запроса к агенту
Через MCP LabTether покажи узлы с высокой загрузкой диска за последний час и найди в журналах, что писал сервис перед ошибкойMCP
- Транспорт
- http
- Авторизация
- API-ключ
Ограничения
- Для установки нужен Docker с `Compose` 2.33.1 или новее. Установщик проверяет контрольные суммы релиза и запускает образы с зафиксированной версией. Сначала скрипт советуют прочитать, и только потом запускать.
- Агент на Windows поддерживается частично: работают метрики и терминал, остальное в разработке. FreeBSD запланирован. Для Linux на amd64 и arm64 и macOS 13 и новее агент готов.
- Хост Docker требует агента, а Proxmox, `TrueNAS`, `Portainer` и Home Assistant подключаются по ключу API без установки.
- Из-за широкого доступа (терминал, файлы, команды) права ключа API для MCP стоит ограничить заранее. Есть файл известных проблем KNOWN_ISSUES.md.
Как отключить. Отзовите ключ API, выданный агенту, и уберите запись LabTether из конфигурации MCP-клиента. Сам хаб останавливают командой docker compose down в папке установки.
Частые вопросы
Как подключить Claude или Cursor к LabTether?
Укажите в MCP-клиенте адрес `https://your-hub:8443/mcp` вашего хаба и ключ API с нужными правами. У встроенного сервера 32 инструмента для лаборатории.
Как ограничить, что может делать агент?
Правами ключа API. Для каждого ключа задаются свои области, поэтому агент затрагивает только то, что вы разрешили. Роли в хабе: владелец, администратор, оператор, наблюдатель.
Что умеет LabTether, кроме MCP?
Показывает узлы, виртуальные машины и контейнеры на одном экране, открывает терминал и удаленный рабочий стол, ведет оповещения и инциденты, строит карту зависимостей, переносит файлы и запускает сохраненные команды по расписанию.
Как поставить LabTether?
Нужен Docker с `Compose` 2.33.1 или новее. Скачайте `install-labtether.sh`, прочтите его и запустите с `LABTETHER_VERSION` из последнего релиза, затем откройте http://localhost:3000 для мастера настройки.
С чем LabTether умеет работать без установки?
С Proxmox VE, Proxmox Backup Server, `TrueNAS`, `Portainer` и Home Assistant: достаточно ключа API. Docker-хосты подключаются через агента.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыПанель домашней лаборатории с MCP-сервером только для чтения: хосты, Docker, GPU, память видеокарт и службы
HomelabHero за одну команду превращает свежий LXC в центр управления домашней лабораторией с Claude Code и брокером доступов.
CLI на Go сравнивает сервер с прошлым снимком, сообщает только значимые перемены и отдает их агенту через MCP
MCP-сервер Proxmox VE с 341 инструментом: виртуальные машины, контейнеры, хранилища, кластер и бэкапы, с режимом только чтения.
MCP-сервер для Proxmox VE: управление виртуалками, LXC, снапшотами и бэкапами из агента с контролем прав и одобрением команд
Платформа на вашем сервере, которая выдает каждому агенту свою Linux-машину с SSH и MCP-инструментами для команд и файлов
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| LabTether (эта карточка) | да | API-ключ | 126 | |
| ProxmoxMCP-Plus | нет | ключ необязателен | 649 | MCP-сервер только для Proxmox VE, а LabTether охватывает хаб, терминал, оповещения и несколько систем |
| Docker MCP от QuantGeekDev | нет | не нужна | 504 | управление контейнерами Docker, а здесь весь парк машин с виртуалками, оповещениями и ролями |
Коротко о README
Страница объясняет проблему разрозненных панелей домашней лаборатории и описывает возможности хаба: единый обзор, коннекторы, терминал и удаленный рабочий стол, оповещения, ежедневные задачи, карта зависимостей, автоматизация и встроенный MCP. Затем идут установка через Docker `Compose`, добавление машин (коннекторы и агенты), таблица платформ и другие входы: CLI, MCP, REST API и Home Assistant.