TrueNAS MCP

一个 MCP 服务器，可将您的 TrueNAS (SCALE) 实例转化为工具。可从任何 MCP 客户端管理存储池、磁盘、数据集、应用、虚拟机等。基于 FastMCP 和官方 truenas_api_client websocket 库构建。

通过持久 websocket 连接使用 TrueNAS API 密钥进行身份验证。目标版本为 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（通用中间件逃生通道）。

许可证

MIT