Diagnose your .env files for missing variables, weak secrets, format issues, and exposed API keys.
A Python MCP server + clean web UI that protects developers from the most common .env mistakes before they become production incidents.
| Check | Severity |
|---|---|
Missing vars from .env.example |
β Error |
| Empty values on required fields | β Error |
| Real API keys / secrets detected | π¨ Critical |
Weak/placeholder values (secret, 123456) |
|
| Wrong format (URLs, ports, booleans, emails) | |
Vars not documented in .env.example |
iοΈ Info |
| Tool | Description |
|---|---|
diagnose_env |
Diagnose .env content passed as a string |
diagnose_env_file |
Diagnose .env file(s) by path on disk |
scan_project |
Scan entire project for all .env variants |
generate_example |
Generate a safe .env.example from your real .env |
pip install mcp python server/server.py
{
"mcpServers": {
"env-doctor": {
"command": "python",
"args": ["/path/to/env-doctor/server/server.py"]
}
}
}{
"mcpServers": {
"env-doctor": {
"command": "npx",
"args": ["mcp-remote", "https://gitmcp.io/nothingtosurprise/env-doctor"]
}
}
}Open frontend/index.html in any browser β no server needed, runs fully client-side.
Features:
- Paste your
.envand.env.examplefor instant diagnosis - Health score (0β100) with visual ring
- Grouped issues by severity
- Generate a safe
.env.examplewith one click - All secrets masked in the report β nothing leaves your browser
"Diagnose my .env file" β paste content β instant report
"Scan my project at /home/user/myapp" β checks all .env variants
"Generate a safe .env.example from my .env" β strips all real values
.env Β· .env.local Β· .env.development Β· .env.production Β· .env.staging Β· .env.test Β· .env.dev Β· .env.prod
MIT