Skip to main content
Glama

TrueNAS MCP

Un servidor MCP que convierte tu instancia de TrueNAS (SCALE) en herramientas. Gestiona pools, discos, datasets, aplicaciones, VMs y más desde cualquier cliente MCP. Basado en FastMCP y la librería websocket oficial truenas_api_client.

Autenticado con una clave API de TrueNAS mediante una conexión websocket persistente. Orientado a TrueNAS 25.10 (pin: TS-25.10.3).

Ejecutar con Docker

Necesitas una instancia de TrueNAS y una clave API (Configuración de la cuenta > Claves 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

Configuración

nombre

predeterminado

notas

TRUENAS_URI

-

obligatoria, URL websocket ws:// o wss://, p. ej. wss://host/api/current

TRUENAS_API_KEY

-

obligatoria, de las claves API de TrueNAS

TRUENAS_VERIFY_SSL

true

poner a false solo con ws:// sin cifrar (desactivar la verificación TLS para certificados autofirmados)

LOG_LEVEL

INFO

Los valores pueden venir de un archivo .env en el directorio de trabajo. La autenticación con clave API usa auth.login_with_api_key a través de la conexión persistente (TrueNAS 25.10 SCRAM - no se necesita nombre de usuario).

Servir mediante HTTP

Por defecto, el servidor usa stdio (un proceso por cliente). Para exponerlo como un endpoint MCP HTTP detrás de una puerta de enlace (p. ej. LiteLLM), configura las variables de entorno de transporte de FastMCP; no se requiere ningún cambio de código:

entorno

predeterminado

FASTMCP_TRANSPORT

stdio

FASTMCP_HOST

127.0.0.1

FASTMCP_PORT

8000

FASTMCP_STREAMABLE_HTTP_PATH

/mcp

Ejemplo: servir streamable-http en todas las interfaces:

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

Herramientas

system_info, list_pools, list_disks, list_datasets, list_apps, list_vms, truenas_call (vía de escape genérica de middleware).

Licencia

MIT

Related MCP Connectors

Related MCP Servers