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

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:

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