TrueNAS MCP
Официальный MCP-сервер TrueNAS: вопросы о пулах, снимках, виртуальных машинах и приложениях на обычном языке.
- 117 ★ репозитория
- Последний коммит
- GPL-3.0
Широкий доступ
Почему такой уровень
- API-ключ с правами администратора позволяет менять хранилище, виртуальные машины и сервисы.
- Записывающие операции необратимы без снимков и резервных копий.
Установка
- Работает в
Ручная установка
Скачай архив своей платформы со страницы релизов вместе с `checksums.txt`, проверь хеш и положи бинарный файл `truenas-mcp` в `PATH`. Создай API-ключ в TrueNAS и добавь сервер в конфигурацию клиента с аргументами `--truenas-url`, `--api-key`, `--api-user`. Для записи сначала проси режим проверки.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- API-ключ с правами администратора позволяет менять хранилище, виртуальные машины и сервисы.
- Записывающие операции необратимы без снимков и резервных копий.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
TrueNAS MCP связывает агента с API системы хранения TrueNAS. Агент читает состояние и метрики, смотрит пулы, наборы данных, снимки и общие папки SMB и NFS, работает с виртуальными машинами, службами каталогов (Active Directory, LDAP, FreeIPA) и каталогом приложений. Записывающие операции можно сначала прогнать в режиме проверки без изменений. Долгие действия (обновления, чистка пула) сопровождаются отслеживанием задач. Это один бинарный файл на вашем компьютере: он подключается к TrueNAS по защищенному WebSocket и общается с клиентом через stdio. Нужен TrueNAS 25.04 или новее.
Для кого. Администраторам TrueNAS, которые хотят спрашивать агента о состоянии массива, снимках и приложениях вместо ручного хождения по веб-интерфейсу.
Подходит, если
- Утренняя проверка: есть ли тревоги и деградация в пулах.
- Перед обновлением хочется просмотреть изменения в режиме проверки.
- Место на массиве тает, и надо найти наборы данных с растущими снимками.
- Установка приложения из каталога с настройкой хранилища идет под руководством агента.
Не подходит, если
- В системе установлен TrueNAS 24.10 или старее: сервер работает только с новым JSON-RPC API.
- Запись данных на массив нельзя доверять агенту даже с подтверждением.
- Продукционная система требует стабильного интерфейса: проект назван исследовательским превью.
Пример запроса к агенту
Покажи состояние пулов и последние тревоги, а затем перечисли снимки, которые занимают больше всего места.MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
Переменные окружения
TRUENAS_URLобязательная- Адрес сервера TrueNAS
TRUENAS_API_KEYобязательная, секрет- API-ключ TrueNAS
TRUENAS_API_USERобязательная- Пользователь, которому принадлежит ключ
Ограничения
Проект назван исследовательским превью, и авторы не рекомендуют его для продуктива; интерфейсы могут меняться. Сервер поддерживает только TrueNAS 25.04 и новее, старые версии получают ошибку рукопожатия. Для работы нужен API-ключ и имя владеющего им пользователя, README советует администратора, поэтому ключ дает широкие права: ограничьте его и храните вне репозиториев. По умолчанию TrueNAS использует самоподписанный сертификат, для проверки задают файл `TRUENAS_TLS_CA`. Для Mac с процессором Intel готового архива нет, сборка из исходников командой `make build`.
Как отключить. Удалите запись `truenas` из конфигурации MCP-клиента и бинарный файл `truenas-mcp`. Ключ отзовите в TrueNAS в разделе API Keys.
Частые вопросы
Какие версии TrueNAS нужны?
25.04 и новее. Сервер использует JSON-RPC по адресу `/api/current` и `auth.login_ex`, а запасного старого протокола нет.
Где взять ключ?
В веб-интерфейсе: System Settings, затем API Keys, кнопка Add. Запомните и пользователя, которому принадлежит ключ, он идет в `--api-user`.
Как подключить Claude Code?
Добавьте сервер `truenas-mcp` с аргументами адреса, ключа и пользователя или с переменными `TRUENAS_URL`, `TRUENAS_API_KEY`, `TRUENAS_API_USER`. Затем перезапустите клиент.
Что с самоподписанным сертификатом?
Проверка включена по умолчанию. Экспортируйте сертификат TrueNAS и укажите путь в `TRUENAS_TLS_CA`.
Можно ли сначала посмотреть изменения?
Да, для записывающих операций есть режим проверки: он показывает, что будет сделано, не меняя систему.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер, встроенный в агент Netdata: метрики, логи, алерты и живые данные о процессах, сервисах и контейнерах для AI-ассистента
Официальный MCP-сервер Cloudflare: агент управляет всем API Cloudflare через поиск по спецификации и выполнение кода
MCP-серверы для Unraid на Python и Rust: состояние массива, Docker, виртуальные машины и телеметрия через GraphQL
MCP-сервер для управления файрволом pfSense через REST API: 332 инструмента, подтверждение опасных операций и откатная ревизия
Официальный MCP-сервер Prometheus: PromQL-запросы, метрики, правила и оповещения плюс встроенные runbook для разбора проблем.
MCP-сервер для диагностики Linux: ИИ-клиент читает службы, журналы и сеть локальных и удаленных систем без права записи
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| TrueNAS MCP (эта карточка) | да | API-ключ | 117 | |
| UniFi MCP server | нет | API-ключ | 351 | управляет сетью UniFi; TrueNAS MCP работает с хранилищем, снимками и виртуальными машинами |
| ProxmoxMCP-Plus | нет | ключ необязателен | 649 | работает с гипервизором Proxmox; TrueNAS MCP относится к массиву и приложениям TrueNAS |
Коротко о README
В README описаны сборка, установка на macOS, Linux и Windows, настройка клиентов, режим проверки, отслеживание задач и список мер безопасности, включая скрытие секретов в выводе.