TrueNAS MCP

MCP-сервер, который превращает ваш инстанс TrueNAS (SCALE) в инструменты. Управляйте пулами, дисками, датасетами, приложениями, ВМ и многим другим из любого MCP-клиента. Построен на FastMCP и официальной websocket-библиотеке truenas_api_client.

Аутентификация выполняется с помощью API-ключа TrueNAS через постоянное websocket-соединение. Ориентировано на TrueNAS 25.10 (закрепление версии: TS-25.10.3).

Запуск с Docker

Вам понадобятся инстанс TrueNAS и API-ключ (Настройки учетной записи > API-ключи).

docker build -t truenas-mcp .
docker run -e TRUENAS_URI=wss://truenas.example.com/api/current \
  -e TRUENAS_API_KEY=your-key \
  truenas-mcp

Related MCP server: truenas-ws-mcp

Настройки

Значения могут быть взяты из файла .env в рабочем каталоге. Аутентификация по API-ключу использует auth.login_with_api_key через постоянное соединение (TrueNAS 25.10 SCRAM - имя пользователя не требуется).

Развёртывание через HTTP

По умолчанию сервер работает через stdio (один процесс на клиента). Чтобы предоставить его как HTTP MCP-эндпоинт за шлюзом (например, LiteLLM), задайте переменные окружения транспорта FastMCP - изменение кода не требуется:

Пример - запуск streamable-http на всех интерфейсах:

FASTMCP_TRANSPORT=streamable-http FASTMCP_HOST=0.0.0.0 FASTMCP_PORT=8000 \
  truenas-mcp

Инструменты

system_info, list_pools, list_disks, list_datasets, list_apps, list_vms, truenas_call (универсальный запасной выход к middleware).

Лицензия

MIT