my-obscura-mcp

Obscura

Rust-native headless browser with built-in MCP server — no Chrome required

What is Obscura?

Obscura is a Rust-based headless browser engine that provides both a Chrome DevTools Protocol (CDP) server and an MCP (Model Context Protocol) server. Run web automation, scraping, and AI-agent workflows without Chrome, Chromium, or Node.js — just a single native binary (~40MB) with built-in stealth mode and AI-optimized content extraction.

Why Obscura?

Quick Start

Download prebuilt binary (recommended)

Linux x86_64:

curl -fsSL https://github.com/SmongsDev/my-obscura-mcp/releases/latest/download/obscura-x86_64-unknown-linux-gnu.tar.gz | tar xz
chmod +x obscura && sudo mv obscura /usr/local/bin/
obscura --version

Linux ARM64:

curl -fsSL https://github.com/SmongsDev/my-obscura-mcp/releases/latest/download/obscura-aarch64-unknown-linux-gnu.tar.gz | tar xz
chmod +x obscura && sudo mv obscura /usr/local/bin/
obscura --version

macOS (Apple Silicon):

curl -fsSL https://github.com/SmongsDev/my-obscura-mcp/releases/latest/download/obscura-aarch64-apple-darwin.tar.gz | tar xz
chmod +x obscura && sudo mv obscura /usr/local/bin/
obscura --version

macOS (Intel):

curl -fsSL https://github.com/SmongsDev/my-obscura-mcp/releases/latest/download/obscura-x86_64-apple-darwin.tar.gz | tar xz
chmod +x obscura && sudo mv obscura /usr/local/bin/
obscura --version

Windows (PowerShell):

$ProgressPreference = 'SilentlyContinue'
Invoke-WebRequest -Uri "https://github.com/SmongsDev/my-obscura-mcp/releases/latest/download/obscura-x86_64-pc-windows-msvc.zip" -OutFile obscura.zip
Expand-Archive obscura.zip -DestinationPath .
.\obscura.exe --version

Build from Source

Prerequisites: Rust 1.75+ (install via rustup.rs)

cargo build --release

Note: First build takes ~5 minutes due to V8 compilation. Subsequent builds use cached artifacts.

The binary will be at target/release/obscura.

MCP Setup

Claude Desktop (macOS / Linux / Windows)

Edit ~/.config/Claude/claude_desktop_config.json (or %APPDATA%\Claude\claude_desktop_config.json on Windows):

{
  "mcpServers": {
    "obscura": {
      "command": "~/.cargo/bin/obscura",
      "args": ["mcp"]
    }
  }
}

Note: Replace ~/.cargo/bin/obscura with the full path to your binary if it's not in the default Cargo installation directory.

Restart Claude Desktop. Obscura tools will appear in the Tools panel.

Cursor

Edit .cursor/mcp.json:

{
  "mcpServers": {
    "obscura": {
      "command": "~/.cargo/bin/obscura",
      "args": ["mcp"]
    }
  }
}

Restart Cursor.

Claude Code (CLI)

Add to your Claude Code settings:

# ~/.claude/settings.json or ~/.claude/settings.local.json
{
  "mcpServers": {
    "obscura": {
      "command": "~/.cargo/bin/obscura",
      "args": ["mcp"]
    }
  }
}

Then restart the Claude Code CLI.

Available Tools

All 29 tools (22 existing + 7 new in v0.3.0):

* = New in v0.3.0

Stealth Mode

Obscura includes built-in stealth mode to avoid bot detection. Use the --stealth flag when starting:

obscura mcp --stealth

Or set via CDP/MCP requests. Stealth mode spoofs TLS fingerprints and browser identifiers.

License

Apache 2.0 — see LICENSE

개요

Obscura는 Chrome 없이 웹 자동화, 스크래핑, AI 에이전트 워크플로우를 실행할 수 있는 Rust 기반 헤드리스 브라우저 엔진입니다. CDP(Chrome DevTools Protocol) 서버와 MCP(Model Context Protocol) 서버를 제공하며, 단일 네이티브 바이너리(~40MB)로 구동되며 내장 스텔스 모드와 AI 최적화 콘텐츠 추출 기능을 갖추고 있습니다.

제공 도구

모든 29개 도구 (기존 22개 + v0.3.0 신규 7개):

* = v0.3.0 신규

스택

• 언어: Rust 1.75+ · Tokio current_thread
• JS 엔진: Deno Core / V8
• HTML 파싱: html5ever
• MCP 프레임워크: rmcp

라이선스

Apache 2.0 — LICENSE 참고