MCP, MCP server
Swag Mcp
SWAG reverse proxy configuration management via MCP.
Compatibility: Not stated.
Grade B
Minor issues only, no Medium or High. Worth a quick look at the findings below before installing.
Not a guarantee. A hygiene check of the source at the commit shown, not a security audit.
PERMISSION_DELETE_FILES NETWORK_NO_FIXED_HOST NETWORK_UNNAMED_HOST SECRETS_PATH_DOTENV INSTALL_DOCUMENTED_INSTALLER SECRETS_ENV_READ OBFUSCATION_FILE_OVER_READ_CAP
Why this grade
- PERMISSION_DELETE_FILES Low
Contains a call that can delete files.
swag_mcp/services/backup_manager.py, line 267
await self.fs.unlink(candidate.path) - NETWORK_NO_FIXED_HOST Low
Makes a network call whose host is not written as a fixed address.
install.sh, line 35
curl -sO https://raw.githubusercontent.com/jmagar/swag-mcp/main/docker-compose.yaml || { - NETWORK_UNNAMED_HOST Low
Calls a fixed host that the description does not name.
install.sh, line 35
curl -sO https://raw.githubusercontent.com/jmagar/swag-mcp/main/docker-compose.yaml || { - SECRETS_PATH_DOTENV Low
Mentions a .env file.
install.sh, line 40
# Handle existing .env file - INSTALL_DOCUMENTED_INSTALLER Note
Documentation shows an installer that pipes a download into a shell.
docs/stack/PRE-REQS.md, line 10
| uv | latest | Dependency management | `curl -LsSf https://astral.sh/uv/install.sh \| sh` | - SECRETS_ENV_READ Note
Reads an environment variable whose name contains KEY, SECRET, TOKEN, PASSWORD or CREDENTIAL.
swag_mcp/server.py, line 443
token = os.getenv("SWAG_MCP_TOKEN") - OBFUSCATION_FILE_OVER_READ_CAP Note
A file was over the read cap and was not fully read.
uv.lock, line 1
version = 1
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
can delete files.
PERMISSION_DELETE_FILES
swag_mcp/services/backup_manager.py, line 267
await self.fs.unlink(candidate.path)
swag_mcp/services/config_operations.py, line 486
await self.fs.unlink(str(config_file))
swag_mcp/services/file_operations.py, line 131
await self.fs.unlink(str(file_path))
Install and update
Note
The docs document an installer that pipes a download into a shell.
INSTALL_DOCUMENTED_INSTALLER
docs/stack/PRE-REQS.md, line 10
| uv | latest | Dependency management | `curl -LsSf https://astral.sh/uv/install.sh \| sh` |
Network
Concern
can reach raw.githubusercontent.com. The description does not name that host. can reach a host that is not written as a fixed address.
NETWORK_NO_FIXED_HOST NETWORK_UNNAMED_HOST
install.sh, line 35
curl -sO https://raw.githubusercontent.com/jmagar/swag-mcp/main/docker-compose.yaml || {
install.sh, line 57
curl -sO https://raw.githubusercontent.com/jmagar/swag-mcp/main/.env.example || {
install.sh, line 71
curl -sO https://raw.githubusercontent.com/jmagar/swag-mcp/main/.env.example || {
Show more
install.sh, line 307
echo "1. Check the service: curl http://localhost:$PORT/health"
bin/smoke-test.sh, line 183
SCHEMA_RESPONSE=$(curl -s "$MCP_URL" -X POST \
bin/smoke-test.sh, line 270
if ! curl -sf "${MCP_BASE_URL}/health" -o /dev/null 2>/dev/null; then
swag_mcp/CLAUDE.md, line 96
curl http://localhost:8000/health
Dockerfile, line 82
CMD python -c "import json, os, urllib.request; data=json.load(urllib.request.urlopen('http://127.0.0.1:8000/health', timeout=5)); assert data.get('status') == 'healthy'; assert os
docker-compose.yaml, line 58
"python -c \"import json, os, urllib.request; data=json.load(urllib.request.urlopen('http://127.0.0.1:8000/health', timeout=5)); assert data.get('status') == 'healthy'; log_dir=os.
Secrets
Concern
reads a credential or environment file.
SECRETS_ENV_READ SECRETS_PATH_DOTENV
install.sh, line 40
# Handle existing .env file
install.sh, line 41
if [ -f .env ]; then
swag_mcp/server.py, line 443
token = os.getenv("SWAG_MCP_TOKEN")
Show more
install.sh, line 42
echo -e "${YELLOW}⚠️ Existing .env file detected${NC}"
install.sh, line 50
echo -e "${GREEN}✅ Keeping existing .env configuration${NC}"
install.sh, line 55
echo "Backing up existing .env to .env.backup"
install.sh, line 56
mv .env .env.backup
install.sh, line 57
curl -sO https://raw.githubusercontent.com/jmagar/swag-mcp/main/.env.example || {
install.sh, line 58
echo -e "${RED}❌ Failed to download .env.example${NC}"
swag_mcp/server.py, line 457
client_secret = os.getenv("FASTMCP_SERVER_AUTH_GOOGLE_CLIENT_SECRET")
swag_mcp/server.py, line 554
token = os.getenv("SWAG_MCP_TOKEN")
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
uv.lock, line 1
version = 1
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 96d8ba123512. can delete files. The docs document an installer that pipes a download into a shell. can reach raw.githubusercontent.com. The description does not name that host. 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:
github.com
Commit graded: 96d8ba1235124881e8a22f37cf6ee01cf4bc35fc
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.