MCP, MCP server
ESP32MCPServer
A Model Context Protocol (MCP) server running on ESP32 (and Nordic nRF52840 in sensor-only mode), exposing real-world sensor data and bus protocols to AI assistants and automation tooling over WebSocket / JSON-RPC 2.0.
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 SECRETS_PATH_CREDENTIAL
Why this grade
- PERMISSION_SHELL_UNDECLARED Medium
Runs shell commands that the manifest or description does not mention.
ai/scripts/ai_dev_helper.py, line 86
subprocess.run(['git', 'checkout', '-b', branch_name]) - SECRETS_PATH_CREDENTIAL Medium
Mentions a credential store path (~/.ssh, id_rsa, .npmrc, .aws/credentials, credentials.json, .netrc).
.gitignore, line 17
credentials.json
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
requests shell access. No manifest field names shell or command execution.
PERMISSION_SHELL_UNDECLARED
ai/scripts/ai_dev_helper.py, line 86
subprocess.run(['git', 'checkout', '-b', branch_name])
ai/scripts/ai_dev_helper.py, line 230
files = subprocess.check_output(['git', 'ls-files', file_pattern]).decode().splitlines()
ai/scripts/ai_dev_helper.py, line 232
files = subprocess.check_output(['git', 'diff', '--name-only']).decode().splitlines()
Show more
ai/scripts/ai_dev_helper.py, line 274
changes = subprocess.check_output(['git', 'diff', '--name-only']).decode().splitlines()
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
examples/client/client.ts, line 16
this.ws = new WebSocket(this.url);
data/app.html, line 251
this.ws = new WebSocket(this.url);
data/app.html, line 589
const resp = await fetch('/discovery');
Show more
data/app.html, line 625
const resp = await fetch('/discovery', { method: 'POST', body: fd });
data/bus_history_config.html, line 104
const r = await fetch('/bus-history');
data/bus_history_config.html, line 155
const r = await fetch('/bus-history', { method: 'POST', body: params,
data/metrics_stats.html, line 256
const response = await fetch(`/api/stats?period=${currentTab}`);
data/wifi_setup.html, line 147
ws = new WebSocket(`ws://${window.location.hostname}/ws`);
Secrets
Concern
reads a credential or environment file.
SECRETS_PATH_CREDENTIAL
.gitignore, line 17
credentials.json
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 27b090554919. 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: 27b090554919049f69c8ac79a1993045f5783b18
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.