MCP, MCP server
Unifi Announcer
Turn a UniFi Protect Smart Chime into a local, programmable announcement speaker.
Compatibility: Not stated.
Grade C
One Medium finding. Read the report before installing.
Not a guarantee. A hygiene check of the source at the commit shown, not a security audit.
PERMISSION_SHELL_UNDECLARED
Why this grade
- PERMISSION_SHELL_UNDECLARED Medium
Runs shell commands that the manifest or description does not mention.
app/main.py, line 1147
p = subprocess.run(
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
Concern
requests shell access. No manifest field names shell or command execution.
PERMISSION_SHELL_UNDECLARED
app/main.py, line 1147
p = subprocess.run(
scripts/release_v2_1.py, line 32
return subprocess.run(command, text=True, capture_output=True, check=False)
scripts/release_v2_1_8.py, line 32
return subprocess.run(command, text=True, capture_output=True, check=False)
Install and update
Pass
No install-time script found, and dependencies are pinned or absent.
Network
Concern
can reach a host that is not written as a fixed address.
NETWORK_NO_FIXED_HOST
app/main.py, line 1818
Consume with: `curl -N http://<host>:8095/events/stream`. Each SSE data
app/main.py, line 1856
accidental curl from taking the doorbell chime down.
scripts/deploy.sh, line 5
curl -s http://localhost:8095/health
Show more
CREDENTIALS.md, line 59
with urllib.request.urlopen(request, context=context, timeout=8) as response:
Secrets
Concern
reads a credential or environment file.
SECRETS_ENV_READ SECRETS_PATH_DOTENV
app/main.py, line 43
# Configuration (all overridable via .env)
app/main.py, line 51
UNIFI_PASSWORD = os.getenv("UNIFI_PASSWORD", "")
app/main.py, line 84
CHIME_DIRECT_PASSWORD = os.getenv("CHIME_DIRECT_PASSWORD", "")
Show more
app/main.py, line 90
APP_API_KEY = os.getenv("APP_API_KEY", "")
app/main.py, line 837
file_path = os.getenv("CHIME_CREDENTIAL_FILE", "")
app/main.py, line 884
MQTT_PASSWORD = os.getenv("MQTT_PASSWORD", "")
app/main.py, line 1016
official_api_key=os.getenv("PROTECT_API_KEY", ""),
app/server.py, line 314
MCP_API_KEY = os.getenv("MCP_API_KEY", "")
app/integrations/mqtt.py, line 57
self.password = os.getenv("MQTT_PASSWORD", "")
scripts/deploy.sh, line 1
# Deploy from the service directory (builds locally, reads sibling .env):
.env.example, line 1
# UniFi Announcer configuration - copy to .env and fill in
.github/workflows/test.yml, line 34
cp .env.example .env
.gitignore, line 1
.env
CREDENTIALS.md, line 35
After revealing the value, you may verify it against the chime's read-only `/api/info` endpoint before saving it in `.env`.
CREDENTIALS.md, line 80
Once the verification returns `HTTP 200`, place the credential in your private `.env` and keep that file mode `0600`:
CREDENTIALS.md, line 91
chmod 600 .env
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 97d97a701055. requests shell access. No manifest field names shell or command execution. can reach a host that is not written as a fixed address. reads a credential or environment file.
Date and source
Date checked:
github.com
Commit graded: 97d97a701055af6db093d8a262bd7d50fd9218e1
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.