Skip to main content
Glama

TrueNAS MCP

Ein MCP-Server, der Ihre TrueNAS-Instanz (SCALE) in Tools verwandelt. Verwalten Sie Pools, Festplatten, Datasets, Apps, VMs und mehr von jedem MCP-Client aus. Basierend auf FastMCP und der offiziellen truenas_api_client-Websocket-Bibliothek.

Authentifiziert mit einem TrueNAS-API-Schlüssel über eine persistente Websocket-Verbindung. Zielt auf TrueNAS 25.10 (Pin: TS-25.10.3).

Mit Docker ausführen

Sie benötigen eine TrueNAS-Instanz und einen API-Schlüssel (Kontoeinstellungen > API-Schlüssel).

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

Einstellungen

name

default

Hinweise

TRUENAS_URI

-

erforderlich, ws:// oder wss:// Websocket-URL, z. B. wss://host/api/current

TRUENAS_API_KEY

-

erforderlich, aus den TrueNAS-API-Schlüsseln

TRUENAS_VERIFY_SSL

true

nur über einfaches ws:// auf false setzen (TLS-Verifizierung für selbstsignierte Zertifikate deaktivieren)

LOG_LEVEL

INFO

Werte können aus einer .env-Datei im Arbeitsverzeichnis stammen. Die API-Schlüssel-Authentifizierung verwendet auth.login_with_api_key über die persistente Verbindung (TrueNAS 25.10 SCRAM - kein Benutzername erforderlich).

Über HTTP bereitstellen

Standardmäßig kommuniziert der Server über stdio (ein Prozess pro Client). Um ihn als HTTP-MCP-Endpunkt hinter einem Gateway (z. B. LiteLLM) bereitzustellen, setzen Sie die FastMCP-Transport-Umgebungsvariablen - keine Codeänderung erforderlich:

env

default

FASTMCP_TRANSPORT

stdio

FASTMCP_HOST

127.0.0.1

FASTMCP_PORT

8000

FASTMCP_STREAMABLE_HTTP_PATH

/mcp

Beispiel - streamable-http auf allen Schnittstellen bereitstellen:

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

Tools

system_info, list_pools, list_disks, list_datasets, list_apps, list_vms, truenas_call (generische Middleware-Notluke).

Lizenz

MIT

Related MCP Connectors

Related MCP Servers