Skip to main content
Glama

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

Настройки

имя

по умолчанию

примечания

TRUENAS_URI

-

обязательный, websocket URL вида ws:// или wss://, например wss://host/api/current

TRUENAS_API_KEY

-

обязательный, из API-ключей TrueNAS

TRUENAS_VERIFY_SSL

true

устанавливайте false только при использовании обычного ws:// (отключает проверку TLS для самоподписанных сертификатов)

LOG_LEVEL

INFO

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

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

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

переменная окружения

по умолчанию

FASTMCP_TRANSPORT

stdio

FASTMCP_HOST

127.0.0.1

FASTMCP_PORT

8000

FASTMCP_STREAMABLE_HTTP_PATH

/mcp

Пример - запуск 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

Related MCP Connectors

Related MCP Servers