Skills/PyPI/truenas-mcp-server

truenas-mcp-server@3.0.2

VERIFIED· not started

Publisher claims: "Production-ready MCP server for TrueNAS Core - Control your NAS through natural language" Observed in sandbox: no network, touches nothing outside the project, writes no memory.

Registry PyPI (MCP server)Publisher vespo92 · publishing for 462 daysInstalls 404Last detonated 1 h ago
$claude mcp add truenas-mcp-server -- uvx truenas-mcp-server
WatchReport an issue

Coverage

Not started: dependency install failed; the server itself was not observed.
Tested
install scripts, with decoy credentials in place · second launch with the clock 45 days ahead · the dependency install step · every file read, file written and host contacted by what ran
Not tested
server startup · the tool list · tool behavior

What this means for the label: Verified here covers what ran. The server's tools were not exercised with a real credential, so nothing about their behavior is asserted; the credential summary below says what to do with that.

Before you give it your token

It will ask for
no credential variables read in the code
Where it talks to
truenas.local (its own)
What we saw when it ran
no credential files read · no network
What we could not test
server startup · the tool list · tool behavior

Connect it under the guard. Not started: dependency install failed; the server itself was not observed. The code names no credential variable and talks to truenas.local, its own; the guard pins the network to what the honeypot saw and logs every call.

$vet-skills run --net declared -- uvx truenas-mcp-server

Never paste a credential into a chat, a ticket or a report, including ours. How the guard holds it.

Is [email protected] safe to install?

KillerSkills ran it in the KillerSkills honeypot sandbox (3 scenarios; not started: dependency install failed; the server itself was not observed) on 2026-11-20 and scored it 82/100 (Verified). In what ran, nothing we could detect went wrong: no undeclared network egress, no credential reads, no persistent instruction writes. What it does with a real credential was not observed; the static findings and the publisher carry the rest of the score. Summary: no network, touches nothing outside the project, writes no memory.

Behavior trace

Honeypot run · 0 s · 3 scenarios · 0 deviations
t+CategoryObserved action
0.0sprocessinstall script run in the sandbox
0.0sprocessexited 1: ModuleNotFoundError: No module named 'setuptools'
0.1sprocessdependency install exit 1 ·
0.1sclaimednot started: dependency install failed (exit 1); the server itself was not observed
0.1sprocessscript backend runs setup only
0.1sprocesssecond launch, clock +45 days, CI unset
0.2sprocessexited 1: ModuleNotFoundError: No module named 'setuptools'

Static findings

MEDIUM
Access to sensitive file pathstests/test_phase2.py:20 · Access to sensitive file paths — SSH keys, AWS credentials, env files, or system filesprint("❌ Error: Please configure TRUENAS_URL and TRUENAS_API_KEY in .env file")Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.
AST05
HIGH
Privileged sudo commandtruenas_mcp_server/models/user.py:21 · Privileged sudo command — agent may execute with elevated privilegessudo: bool = Field(False, description="Has sudo privileges")Fix: Build commands from fixed arguments; do not interpolate untrusted strings into a shell.
AST05
MEDIUM
Access to sensitive file pathstests/test_connection.py:20 · Access to sensitive file paths — SSH keys, AWS credentials, env files, or system filesprint("❌ Error: Please configure TRUENAS_URL and TRUENAS_API_KEY in .env file")Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.
AST05
MEDIUM
Access to sensitive file pathstests/test_api_direct.py:11 · Access to sensitive file paths — SSH keys, AWS credentials, env files, or system filesenv_path = Path(__file__).parent / ".env"Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.
AST05
MEDIUM
Access to sensitive file pathstests/test_api_direct.py:10 · Access to sensitive file paths — SSH keys, AWS credentials, env files, or system files# Read .env file directlyFix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.
AST05
HIGH
Privileged sudo commandtruenas_mcp_server/tools/users.py:155 · Privileged sudo command — agent may execute with elevated privilegessudo: Whether to grant sudo privilegesFix: Build commands from fixed arguments; do not interpolate untrusted strings into a shell.
AST05
HIGH
Privileged sudo commandtruenas_mcp_server/tools/users.py:169 · Privileged sudo command — agent may execute with elevated privileges"sudo": sudoFix: Build commands from fixed arguments; do not interpolate untrusted strings into a shell.
AST05
MEDIUM
Access to sensitive file pathsMakefile:65 · Access to sensitive file paths — SSH keys, AWS credentials, env files, or system filescp .env.example .env; \Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.
AST05
HIGH
Privileged sudo commandtruenas_mcp_server/models/user.py:53 · Privileged sudo command — agent may execute with elevated privilegessudo: bool = Field(False, description="Grant sudo privileges")Fix: Build commands from fixed arguments; do not interpolate untrusted strings into a shell.
AST05
LOW
Authorization escalation languageREADME.md:125 · Authorization escalation language · informational: not an instruction file"Show me users who have sudo privileges"Fix: Remove the text that addresses the agent rather than the reader; describe behavior, do not instruct.
AST01
LOW
URL to a private-network addressclaude_config_example.json:9 · URL to a private-network address — a LAN or development target"TRUENAS_URL": "https://192.168.1.100",Fix: Replace encoded or assembled strings with plain literals and remove undeclared network calls.
AST07
MEDIUM
Access to sensitive file pathsMakefile:66 · Access to sensitive file paths — SSH keys, AWS credentials, env files, or system filesecho "✅ Created .env file - please edit with your TrueNAS details"; \Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.
AST05
LOW
URL to a private-network addressclaude_desktop_config_direct.json:20 · URL to a private-network address — a LAN or development target"TRUENAS_URL": "https://10.0.0.14",Fix: Replace encoded or assembled strings with plain literals and remove undeclared network calls.
AST07
HIGH
Access to sensitive file pathstruenas_mcp_server/config/settings.py:159 · Access to sensitive file paths — SSH keys, AWS credentials, env files, or system files"env_file": ".env",Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.
AST05
MEDIUM
Access to sensitive file pathsMakefile:63 · Access to sensitive file paths — SSH keys, AWS credentials, env files, or system files@echo "📋 Creating .env from example..."Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.
AST05
MEDIUM
Access to sensitive file pathsMakefile:64 · Access to sensitive file paths — SSH keys, AWS credentials, env files, or system files@if [ ! -f .env ]; then \Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.
AST05
LOW
Authorization escalation languagedocs/guides/FEATURES.md:49 · Authorization escalation language · informational: not an instruction file- Check sudo privileges and shell accessFix: Remove the text that addresses the agent rather than the reader; describe behavior, do not instruct.
AST01

Cost to the agent

Instructions loaded
≈61 tok
1 file · 59 in bundle
Tool list per prompt
≈0 tok
0 tools · 0 per tool
Handshake
no reply
launch to tools/list, stdio
Undocumented tools
0
description under 20 chars · avg 0

Tokens estimated at four characters each. The tool list is re-read by the agent on every turn, so it is the number to compare between servers that do the same job: ranked across the index.

Known vulnerabilities

Not checked against OSV yet; the weekly check has not reached this version.

truenas-mcp-server@3.0.2 safety verdict: Verified (not started) — KillerSkills