jdcodec 0.4.0

JD Codec — privacy-first local MCP proxy for browser-agent tasks. Compresses page snapshots ~80%+ via a cloud codec; PII never leaves your machine.

jdcodec — Python Distribution

pip install jdcodec

A privacy-first local proxy for browser-agent task pipelines. The Python distribution is a thin wrapper that delegates to the JD Codec connector — it gives you pip install jdcodec ergonomics with the connector running under the hood via Node.

What it does

• Compresses browser-agent page snapshots so your agent's context window goes much further on long tasks.
• Scans every snapshot on your machine for PII (emails, phone numbers, credit cards, API keys, addresses, and more) and replaces them with category tokens before any bytes leave your network.
• Falls back to a local-only mode if the cloud service is unreachable — your agent never blocks on us.

Requirements

• Python 3.8 or newer
• Node.js 22 or newer on your PATH (install from https://nodejs.org/ or brew install node / apt install nodejs npm)
• An MCP-capable agent client (Claude Code, Cursor, or any client that speaks MCP stdio)
• A JD Codec API key — email [e-mail]

Usage

The jdcodec command exposes three surfaces:

pip install jdcodec
jdcodec                 # launches the local MCP proxy — point your
                        #   MCP-capable agent client at this command
jdcodec audit           # one-shot environment audit (detects langchain /
                        #   playwright / browser-use, posts a telemetry
                        #   ping). `jdcodec-audit` is an alias.
jdcodec start           # registers your machine for the alpha waitlist —
                        #   opens browser-based OAuth, captures email,
                        #   attaches it to your audit. `jdcodec login`
                        #   is an alias.

The first MCP-proxy invocation fetches and caches the connector via npx (a few seconds; instant on subsequent runs).

Pinning a specific connector version

By default the wrapper resolves to the latest published connector. To pin:

JDC_CONNECTOR_VERSION=0.3.1 jdcodec

Version pinning only applies to the MCP-proxy path (which shells through to npm). The audit / start / login subcommands are local Python and don't read this variable.

Wiring it into your agent

The Python wrapper exposes the same jdcodec command as the npm distribution. Point your MCP client config at jdcodec (not npx @playwright/mcp) and the connector takes over. Specific guides for Claude Code, Cursor, and generic MCP clients are available — email [e-mail] for access.

Configuration

Set your API key either as an environment variable or in a config file:

export JDC_API_KEY='jdck_yourid.yoursecret'

Or:

mkdir -p ~/.jdcodec
cat > ~/.jdcodec/config.json <<EOF
{ "api_key": "jdck_yourid.yoursecret" }
EOF
chmod 600 ~/.jdcodec/config.json

The full env-var reference (JDC_BYPASS, JDC_REGION, JDC_TRACE, etc.) is documented in the npm package's README — npm view jdcodec readme or visit https://www.npmjs.com/package/jdcodec.

Support

Email [e-mail] for alpha access, API keys, bug reports, or feature requests.