envguard
Detects and audits exposed GitHub tokens in environment files during secret scanning.
Detects and audits exposed OpenAI API keys in environment files during secret scanning.
Detects and audits exposed Slack tokens in environment files during secret scanning.
Detects and audits exposed Stripe API keys in environment files during secret scanning.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
EnvGuard Secrets Vault
Zero-dependency .env secret scanner, credential masker, authenticated AES-256-CTR-HMAC-SHA256 vault, GF(256) Shamir's Secret Sharing quorum engine, TTL secret rotation sentinel, and 11-tool Model Context Protocol (MCP) server.
Overview
EnvGuard Secrets Vault (envguard-secrets-vault) is implemented in pure Python 3 standard library code (src/envguard_secrets_vault/) paired with a local loopback REST server (127.0.0.1:8088) and standalone Web Crypto browser studio (public/index.html). It integrates with Zoth Studio v2 (https://zoth.nullai.tech/tools/envguard-secrets-vault) and ZothOS v3.4.0.
Property | Value |
Tool ID |
|
Category |
|
Loopback Bind |
|
Zoth Studio v2 Dossier |
|
Local Studio Route |
|
Python Package |
|
MCP Protocol | JSON-RPC 2.0 over |
License | MIT (100% free and open-source) |
Related MCP server: secrets-mcp-server
Architecture
flowchart LR
CLI["envguard CLI / bin/envguard.js"] --> CORE["src/envguard_secrets_vault"]
MCP["MCP Clients (Claude / Cursor / Hermes)"] -->|stdio JSON-RPC 2.0| MCP_SRV["mcp_server.py (11 Tools)"]
UI["public/index.html"] --> HTTP["server.py / ui_server.py (127.0.0.1:8088)"]
MCP_SRV --> CORE
HTTP --> CORE
CORE --> SCAN["scanner.py + entropy_analyzer.py"]
CORE --> VAULT["vault.py (PBKDF2 + AES-256-CTR-HMAC-SHA256)"]
CORE --> SHAMIR["shamir_quorum.py (GF(256) k-of-n)"]
CORE --> ROTATE["secret_rotation_sentinel.py"]Secret Scanner & Entropy Analyzer (
scanner.py,entropy_analyzer.py): Evaluates.envfiles and source trees against 50+ provider token signatures (OpenAI, Anthropic, AWS, Stripe, GitHub, Slack, JWTs, PEM private keys, database DSNs), framework client-bundle prefix leaks (NEXT_PUBLIC_,VITE_,REACT_APP_), and alphabet-aware Shannon entropy thresholds.Armored Vault (
vault.py): Encrypts plaintext.envconfigurations into ASCII-armoredENVGUARD ENCRYPTED VAULTpayloads using PBKDF2-HMAC-SHA256 key derivation and Encrypt-then-MAC (AES-256-CTR+HMAC-SHA256).Shamir Quorum (
shamir_quorum.py): Splits master keys or.envsecrets over $GF(2^8)$ into $n$ armored shares requiring any $k$ shares for reconstruction.Secret Rotation Sentinel (
secret_rotation_sentinel.py): Parses# @created,# @expires, and# @rotation_dayslifecycle comments, computes compliance scores, and rotates expired keys with provider-formatted replacement tokens and unified diffs.
Quickstart
Clone the repository and install the package in editable mode:
git clone https://github.com/1nc0gn30/envguard-secrets-vault.git
cd envguard-secrets-vault
pip install -e .
# Verify CLI installation
envguard --version
envguard --help
# Start the loopback REST & Web Studio server on http://127.0.0.1:8088
python3 server.pyOpen http://127.0.0.1:8088 in a browser, or query the loopback REST API:
# Service health and diagnostics
curl -s http://127.0.0.1:8088/health | python3 -m json.tool
curl -s http://127.0.0.1:8088/api/diagnostics | python3 -m json.tool
# Scan raw .env content via REST
curl -s -X POST http://127.0.0.1:8088/api/scan \
-H "Content-Type: application/json" \
-d '{"content":"PORT=8080\nAWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE"}' \
| python3 -m json.toolREST API Endpoints (127.0.0.1:8088)
Method | Route | Description |
|
| Service health check ( |
|
| Runtime Python, OS, cipher suite, and detector diagnostics. |
|
| Generates MCP client JSON configurations ( |
|
| Scans |
|
| Masks secret values ( |
|
| Generates a sanitized |
|
| Encrypts or decrypts armored |
|
| Diffs two |
|
| Splits or reconstructs GF(256) Shamir secret shares. |
|
| Audits TTL metadata or rotates targeted secret keys. |
|
| Bundles sanitized |
CLI & MCP Usage
CLI Subcommands (envguard / python3 -m envguard_secrets_vault)
# Scan a .env file or directory (exit non-zero if below --min-score)
envguard scan examples/nextjs-env-audit/.env.production
envguard scan examples/nextjs-env-audit/.env.production --json --min-score 80
# CI/CD pre-commit security gate (text, github, json, markdown)
envguard check ./examples --min-score 85 --format json
# Redact sensitive values or generate .env.example
envguard mask examples/nextjs-env-audit/.env.production --mode partial
envguard example examples/nextjs-env-audit/.env.production --output /tmp/.env.example
# Encrypt and decrypt armored vault files
envguard encrypt /tmp/.env.example --password "StrongVaultPassword!99" --out /tmp/secrets.env.enc
envguard decrypt /tmp/secrets.env.enc --password "StrongVaultPassword!99"
# Compare two environment files
envguard diff examples/nextjs-env-audit/.env.production examples/nextjs-env-audit/.env.example --json
# Shamir's Secret Sharing (k-of-n threshold quorum)
envguard shamir split "MasterSigningSecret" --threshold 3 --shares 5 --json
# Audit secret lifetimes and execute rotation diff
envguard rotate examples/nextjs-env-audit/.env.production --audit-only --json
envguard rotate examples/nextjs-env-audit/.env.production --diff
# Launch HTTP server or print runtime platform specs
envguard serve --host 127.0.0.1 --port 8088
envguard platformOn ZothOS v3.4.0, the Node/Electron launcher (./bin/envguard.js / envguard-secrets-vault) and Unicode U+2800 Braille TUI (./bin/envguard-secrets-vault-tui --json) are also available.
Model Context Protocol (MCP) Server
Run envguard mcp (or python3 -m envguard_secrets_vault mcp) to expose all 11 tools over stdio JSON-RPC 2.0:
{
"mcpServers": {
"envguard": {
"command": "python3",
"args": ["-m", "envguard_secrets_vault", "mcp"]
}
}
}Exposed MCP tools: env_scan_secrets, env_mask_variables, env_generate_example, env_vault_encrypt, env_vault_decrypt, env_diff_environments, env_get_diagnostics, env_shamir_split, env_shamir_combine, env_audit_rotation, env_rotate_secrets.
Python Library API
from envguard_secrets_vault import (
scan_secrets,
vault_encrypt,
vault_decrypt,
split_secret_into_shares,
combine_shares_to_secret,
)
report = scan_secrets("PORT=8088\nAWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE")
encrypted = vault_encrypt("APP_ENV=production\n", "MasterPass!99")
decrypted = vault_decrypt(encrypted["vault_armor"], "MasterPass!99")
quorum = split_secret_into_shares("MasterPass!99", threshold=2, total_shares=3)
recovered = combine_shares_to_secret(quorum["shares"][:2])Documentation
Testing & Verification
# Run the full pytest suite
python3 -m pytest -q
# Run the built-in self-test command
envguard testSupport
100% free and open-access software with zero paywalls or feature gates. Optional community support:
Solana Tip:
GG2eQbVh8ut1BK6j1A2tz7pSySdLpD38BgyEhGcxdXoK
License
Released under the MIT License. Engineered by Neal Frazier Tech (@1nc0gn30) & NullAI Platform.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Secrets for developers and agents—secure context and workflows without exposing secret values.
Security gateway for AI agents: policy, approval, and audited execution, no secrets shared.
Governed access to sensitive data, secrets and APIs for AI agents. A signed proof for each decision.
Encrypted secret store and rotation for autonomous agent credentials
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to securely use secrets by running commands with environment-injected credentials and sanitizing output to prevent leakage.294 npm1MIT
- AlicenseCqualityCmaintenanceEnables AI agents to securely store and manage encrypted secrets locally while using them indirectly through environment-variable injection or file writes, so plaintext values never enter the agent's context.8MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI coding agents to securely inject API keys and secrets into environment files, configs, or commands without the agent ever seeing the secret values.10 npmMIT
- AlicenseBqualityCmaintenanceEnables AI agents to use vault-stored credentials without ever exposing plaintext secrets to model context, transcripts, or telemetry. It decrypts AES-256-GCM envelopes locally via WebCrypto, resolves opaque secret handles into subprocess environments and outbound HTTP requests, issues auto-zeroizing time-bounded leases, and scrubs echoed credentials from output.19MIT