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

設定

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

HTTP で提供

デフォルトではサーバーは stdio で通信します (クライアントごとに 1 プロセス)。ゲートウェイ (例: LiteLLM) の背後で HTTP MCP エンドポイントとして公開するには、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