MCP SERVERObfuscate a Python project and verify it still imports — then un-mangle the stack trace when production breaks.
LABSCO SUMMARY
Obfuscation breaks on eval, reflection and framework magic, and it breaks quietly — the transform succeeds and the import fails much later. protect_project byte-compiles and import-smoke-tests the output and answers verified true or false, and the mapping file is what turns the resulting production stack trace back into something a person can read.
The MCP server for pyobfus, an AST-based Python obfuscator. It scans a project for the patterns that break obfuscation, picks a framework-aware preset, obfuscates, then byte-compiles and import-smoke-tests the output before reporting back.
The pyobfus-mcp package from PyPI over stdio — uvx pyobfus-mcp needs no install, or pip install pyobfus-mcp. It is registered as io.github.zhurong2020/pyobfus-mcp. No account or key. The server makes no outbound calls by default; the PyPI dependency lookup only runs when verify_dependencies_online=true. unmap_stack_trace needs a mapping file, which exists only if the build ran with --save-mapping. Some presets are Pro; the trial is started by running pyobfus-trial start in your own shell, not by the server.
One command — pip install pyobfus-mcp
USE CASES
Scan for the risky patterns first, then obfuscate through a pipeline that verifies the output still imports.
Paste the trace and the mapping file path and get the original identifiers back.
Auto-detect FastAPI, Django, Flask or SQLAlchemy and write a matching pyobfus.yaml.
Excluded names and patterns, parameter-name preservation and docstring handling, listed per preset.
Check declared dependencies against public PyPI before anything gets installed.
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
check_obfuscation_risksScan a Python project for patterns that may break obfuscation (eval/exec, dynamic attribute access, framework reflection, unsafe model loading). Returns severity counts, detected frameworks (FastAPI/Django/Flask/Pydantic/Click/SQLAlchemy/ML), and a suggested preset.
explain_presetDescribe what a named preset changes: exclude names count, exclude patterns, preserve_param_names, docstring handling. For Pro presets, returns full pro_unlock metadata (trial command, checkout URL, price, money-back guarantee).
generate_pyobfus_configGenerate a pyobfus.yaml for a Python project. Auto-detects frameworks and applies the matching preset. By default returns the YAML text without writing to disk; set write=true to persist.
list_presetsList every pyobfus preset available, grouped by tier (community / framework-aware / Pro).
protect_projectOne call to protect a Python project end-to-end AND verify it still works: scans risks, picks a framework-aware preset, obfuscates, then byte-compiles + import-smoke-tests the output in isolated subprocesses and returns verified:true/false. Writes a private de-obfuscation mapping alongside (not inside) the output. Use this when the user wants to 'protect/obfuscate before shipping' and expects a green check, not just a transform.
recommend_tierAnalyze a Python project and recommend pyobfus tier (community vs Pro) with reasons. Combines a preflight scan with a sensitive-string-literal heuristic. Returns free_action and pro_action with concrete next-step commands.
start_pro_trialReturn structured guidance for starting the 5-day pyobfus Pro trial. Does NOT invoke the side effect — the user runs pyobfus-trial start in their shell. Detects whether a trial is already active and surfaces the appropriate next step plus post-trial purchase URL.
unmap_stack_traceReverse obfuscated identifiers in a stack trace using a pyobfus mapping.json. Accepts the trace as plain text and the path to a mapping file produced by --save-mapping.
BEFORE YOU INSTALL
8 tools when we connected.
Python 3.10+
CONTEXT COST
Rated by the size of the 8 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
pip install pyobfus-mcp{
"mcpServers": {
"pyobfus": {
"command": "pyobfus-mcp"
}
}
}{
"context_servers": {
"pyobfus": {
"command": {
"path": "pyobfus-mcp",
"args": []
}
}
}
}claude mcp add pyobfus pyobfus-mcp/plugin marketplace add zhurong2020/pyobfus
/plugin install pyobfus@pyobfusMCP servers
disler
stippi
dave-hillier
kalivaraprasad-gonapa