Skip to main content
Glama

TrueNAS MCP

TrueNAS (SCALE) インスタンスをツールに変える MCP サーバー。プール、ディスク、データセット、アプリ、VM などを任意の MCP クライアントから管理できます。FastMCP と公式の truenas_api_client websocket ライブラリ上に構築されています。

TrueNAS API キーで認証し、永続的な websocket 接続を使用します。TrueNAS 25.10 (pin: TS-25.10.3) を対象としています。

Docker で実行

TrueNAS インスタンスと API キーが必要です (Account Settings > API Keys)。

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

設定

name

default

notes

TRUENAS_URI

-

必須、ws:// または wss:// websocket URL、例: wss://host/api/current

TRUENAS_API_KEY

-

必須、TrueNAS API Keys から取得

TRUENAS_VERIFY_SSL

true

平文の ws:// でのみ false に設定 (自己署名証明書の TLS 検証を無効化)

LOG_LEVEL

INFO

値は作業ディレクトリの .env ファイルから取得できます。API キー認証は永続接続上の auth.login_with_api_key を使用します (TrueNAS 25.10 SCRAM - ユーザー名は不要)。

HTTP で提供

デフォルトではサーバーは stdio で通信します (クライアントごとに 1 プロセス)。ゲートウェイ (例: LiteLLM) の背後で HTTP MCP エンドポイントとして公開するには、FastMCP トランスポート環境変数を設定します - コードの変更は不要です:

env

default

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 (汎用ミドルウェアのエスケープハッチ)。

ライセンス

MIT

Related MCP Connectors

Related MCP Servers