Grades are a hygiene check, not a security guarantee.

MCP, MCP server

Mcp Truenas

An MCP (Model Context Protocol) server that lets Claude monitor and manage a TrueNAS box in plain English: "any alerts on the NAS?", "how full is tank?", "list snapshots of appdata".

Compatibility: Not stated.

Grade C

One Medium finding. Read the report before installing.

Graded by PlugVetRubric v2

Not a guarantee. A hygiene check of the source at the commit shown, not a security audit.

INSTALL_LIFECYCLE_HOOK

Why this grade

  • INSTALL_LIFECYCLE_HOOK Medium

    A package install hook (preinstall, install, postinstall or prepare) runs a script.

    package.json, line 22 prepare

Any High, or two or more Medium findings, give D. One Medium gives C. Low findings or a security Note give B. Each code names a finding behind the letter.

Grades are a hygiene check of the source at the commit shown, on the date checked, not a security audit or a guarantee. The free directory grades are automated. Before release, a PlugVet engineer reviews every paid report and any grade we hold back, including all F grades, against the source code and the evidence we quote.

What was checked

Plain notes from the hygiene checks.

  • Permissions

    Pass

    No shell or command execution found, and no extra permission was declared.

  • Install and update

    Concern

    runs a script at install time.

    INSTALL_LIFECYCLE_HOOK

    package.json, line 22

    prepare

  • Network

    Concern

    can reach a host that is not written as a fixed address.

    NETWORK_NO_FIXED_HOST

    src/truenas-client.ts, line 258

    const socket = new WebSocket(this.wsUrl(), {

    src/truenas-client.ts, line 410

    const res = await this.http.get(`/api/v2.0${path}`, { headers: this.restHeaders(), params });

  • Secrets

    Concern

    reads a credential or environment file.

    SECRETS_ENV_READ SECRETS_PATH_DOTENV

    scripts/apply-staged-update.mjs, line 6

    // are destructive-tier and TRUENAS_ENABLE_DESTRUCTIVE is deliberately left unset in .env.

    scripts/apply-staged-update.mjs, line 41

    // Which TrueNAS: ../.env is the box at View (default). TRUENAS_ENV_FILE=.env.rex selects the box at Rex.

    scripts/apply-staged-update.mjs, line 44

    if (!/^\.env(\.[a-z0-9-]+)?$/.test(ENV_FILE)) throw new Error(`TRUENAS_ENV_FILE must be .env or .env.<name>, got ${ENV_FILE}`);

    Show more

    scripts/apply-staged-update.mjs, line 52

    apiKey: process.env.TRUENAS_API_KEY,

    src/index.ts, line 24

    // Configuration - read from a .env file next to package.json, or from env

    src/index.ts, line 29

    process.loadEnvFile(path.join(projectRoot, ".env"));

    src/index.ts, line 31

    // No .env file - fine when the MCP client supplies env vars itself.

    src/index.ts, line 36

    apiKey: process.env.TRUENAS_API_KEY ?? "",

    src/truenas-client.ts, line 153

    "the .env file next to package.json), e.g. TRUENAS_URL=https://192.168.1.50"

    src/truenas-client.ts, line 179

    "and set it in this server's MCP registration env. Use the .env file only for a single-NAS setup: it " +

  • Agent instructions

    Pass

    No instruction to ignore earlier instructions or to hide a step.

  • Obfuscation

    Note

    a file was over the read cap and was not fully read.

    OBFUSCATION_FILE_OVER_READ_CAP

    src/tools.ts, line 1

    /**

  • Licence

    Pass

    A licence file is present (LICENSE).

  • Maintainer activity

    Pass

    The latest commit is within the last 365 days.

Get the full report on this tool, £49

Note

Hygiene check of commit a7b545d162eb. runs a script at install time. can reach a host that is not written as a fixed address. reads a credential or environment file. a file was over the read cap and was not fully read.

Date and source

Date checked:

View source

github.com

Commit graded: a7b545d162eb4dcc1d99676b5e959a66d583c9a1

This link goes to the original host. PlugVet does not host or check what you download from there, and installing it is your own decision and risk.

Read how this letter is chosen