h4ckf0r0day/obscura v0.1.4

🐳 v0.1.4: MCP + Docker

on GitHub

Major features

MCP server (#65)

obscura mcp exposes 12 browser tools over Model Context Protocol with both stdio and HTTP transports. Drop into Claude Code, Cursor, Aider, or any MCP client to drive Obscura directly from an AI agent. No Playwright glue code needed.

Tools: browser_navigate, browser_snapshot, browser_click, browser_fill, browser_type, browser_press_key, browser_select_option, browser_evaluate, browser_wait_for, browser_network_requests, browser_console_messages, browser_close.

Docker support

Official image on Docker Hub. Multi-stage build on distroless/cc, around 57 MB compressed, no shell, no package manager.

docker run -d -p 127.0.0.1:9222:9222 h4ckf0r0day/obscura

Future releases auto-publish to Docker Hub via GitHub Actions.

--host flag for obscura serve

Defaults to 127.0.0.1 for safety (loopback only). Set --host 0.0.0.0 to expose the port externally, which is what the Docker image does internally so docker run -p 9222:9222 actually works.

Compatibility

Works as a drop-in CDP replacement for:

• Playwright via connect_over_cdp
• Puppeteer via browserWSEndpoint
• chromiumoxide and headless_chrome (Rust CDP clients)
• Any MCP client

Install

# Docker (new)
docker run -d -p 127.0.0.1:9222:9222 h4ckf0r0day/obscura

# Binary (Linux, macOS arm64, macOS Intel, Windows)
# See assets below or the README

Closed issues

#119