MCP, MCP server
Homelab Guardian
The safety layer between an AI agent and root.
Compatibility: Not stated.
Grade D
Two or more Medium findings, or a High. Only try it in a sandbox.
Not a guarantee. A hygiene check of the source at the commit shown, not a security audit.
PERMISSION_SHELL_UNDECLARED NETWORK_HOST_FROM_INPUT
Why this grade
- PERMISSION_SHELL_UNDECLARED Medium
Runs shell commands that the manifest or description does not mention.
homelab_guardian/configedit.py, line 464
os.remove(tmp) - NETWORK_HOST_FROM_INPUT Medium
A file takes a URL or endpoint as input and has no fixed host list.
homelab_guardian/dnsquery.py, line 94
with socket.create_connection((server, port), timeout=timeout) as tcp:
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.
If you think this grade is wrong, email [email protected] with the entry link and your evidence. We aim to acknowledge within two working days and decide within seven. If we confirm an error, we aim to correct it within 24 hours of confirming it. These are aims, not guarantees.
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
Concern
can delete files. requests shell access. No manifest field names shell or command execution.
PERMISSION_SHELL_UNDECLARED PERMISSION_DELETE_FILES
homelab_guardian/configedit.py, line 464
os.remove(tmp)
homelab_guardian/doctor.py, line 292
out = subprocess.run(["sudo", "-n", "-l"], capture_output=True, text=True, timeout=8)
homelab_guardian/repair.py, line 434
runner: Callable[..., subprocess.CompletedProcess] = subprocess.run,
Show more
homelab_guardian/repair.py, line 568
runner: Callable[..., subprocess.CompletedProcess] = subprocess.run,
homelab_guardian/repair.py, line 653
def auto_repair_confirmed(config, conn, events, runner: Callable[..., subprocess.CompletedProcess] = subprocess.run):
homelab_guardian/repair.py, line 702
def _escalation_diagnostic(check, runner: Callable[..., subprocess.CompletedProcess] = subprocess.run) -> str:
homelab_guardian/secrets.py, line 73
self._runner = runner or subprocess.run
homelab_guardian/collectors/backup_health_collector.py, line 191
runner: Callable[..., subprocess.CompletedProcess] = subprocess.run,
Install and update
Concern
dependencies are not pinned.
INSTALL_UNPINNED
requirements.txt, line 1
PyYAML>=6.0.1
Network
Serious
accepts a host from input, with no fixed list in this file.
NETWORK_HOST_FROM_INPUT
homelab_guardian/dnsquery.py, line 94
with socket.create_connection((server, port), timeout=timeout) as tcp:
homelab_guardian/explain.py, line 102
response = requests.post( # nosec B113
homelab_guardian/tls.py, line 73
with socket.create_connection((host, port), timeout=timeout) as raw:
Show more
homelab_guardian/tls.py, line 86
with socket.create_connection((host, port), timeout=timeout) as raw:
homelab_guardian/web.py, line 617
fetch(window.location.href, { cache: "no-store" }).then(function (r) {
homelab_guardian/webauth_oidc.py, line 135
resp = requests.get(self.issuer + "/.well-known/openid-configuration", timeout=10)
homelab_guardian/webauth_oidc.py, line 252
resp = requests.post(
homelab_guardian/wizard.py, line 78
with socket.create_connection((ip, port), timeout=timeout):
homelab_guardian/collectors/homeassistant_collector.py, line 57
response = requests.get(f"{url}{READ_ONLY_STATES_ENDPOINT}", headers=headers, timeout=timeout)
homelab_guardian/collectors/network_collector.py, line 142
with socket.create_connection((host, port_num), timeout=timeout):
homelab_guardian/collectors/network_collector.py, line 185
response = requests.request(method, url, timeout=timeout, allow_redirects=True, verify=verify_tls)
Secrets
Concern
reads a credential or environment file.
SECRETS_PATH_DOTENV
homelab_guardian/main.py, line 325
def load_dotenv(path: str | Path = ".env") -> int:
homelab_guardian/main.py, line 326
"""Load KEY=VALUE lines from a local .env file into the environment
homelab_guardian/main.py, line 328
'write tokens to .env' flow working for bare `guardian` runs, matching
Show more
homelab_guardian/wizard.py, line 415
print(" Generated a bearer token (saved to .env as GUARDIAN_MCP_TOKEN).")
homelab_guardian/wizard.py, line 442
if _ask_yes_no("Use Bitwarden Secrets Manager instead of a local .env file? (advanced)", default=False):
homelab_guardian/wizard.py, line 456
env_path = output.parent / ".env"
homelab_guardian/wizard.py, line 475
print(" from .env (GUARDIAN_MCP_TOKEN). See docs/mcp.md.")
homelab_guardian/collectors/homeassistant_collector.py, line 65
"Create a new long-lived access token, update only the local .env value, and retry. Do not commit the token.",
Agent instructions
Pass
No instruction to ignore earlier instructions or to hide a step.
Obfuscation
Pass
No encoded or minified payload found.
Licence
Pass
A licence file is present (LICENSE).
Maintainer activity
Pass
The latest commit is within the last 365 days.
Note
Hygiene check of commit 94ffd2054f6c. can delete files. requests shell access. No manifest field names shell or command execution. dependencies are not pinned. accepts a host from input, with no fixed list in this file. reads a credential or environment file.
Date and source
Date checked:
github.com
Commit graded: 94ffd2054f6c001f59267db93c7330e45f8b9bda
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.