obscura-mcp

Ein MCP-Server-Adapter für Obscura, einen leichtgewichtigen, in Rust geschriebenen Headless-Browser für Scraping und KI-Agenten-Automatisierung.

Stellt Obscuras native CDP-Funktionen über eine saubere MCP-Schnittstelle bereit – keine Chrome-Abhängigkeit, keine schwerfällige Browser-Automatisierung.

Installation

npm install -g obscura-mcp

Die Installation erfolgt sofort – die Browser-Binärdatei (~80 MB) wird bei der ersten Verwendung verzögert heruntergeladen.

Führen Sie nach der Installation entweder:

• obscura-mcp install aus, um die Binärdatei mit sichtbarem Fortschritt herunterzuladen, oder

• einfach obscura-mcp aus – die Binärdatei wird automatisch heruntergeladen und der Server gestartet.

Die Binärdatei wird unter ~/.obscura/bin/ zwischengespeichert und übersteht npm-Upgrades.

Um einen benutzerdefinierten Pfad zur Binärdatei zu verwenden:

export OBSCURA_PATH=/path/to/obscura

Related MCP server: Algonius Browser

Schnellstart

# Install
npm install -g obscura-mcp

# Verify
obscura-mcp --version

# Download browser binary
obscura-mcp install

# Start MCP server
obscura-mcp --transport stdio

Tools

browse_url

Ruft eine URL mithilfe der CDP-Engine von Obscura ab. Gibt den Seiteninhalt zurück.

Parameter:

• url (string, erforderlich): HTTP- oder HTTPS-URL, die besucht werden soll.

• dump (string, optional): html, text oder links. Standardwert ist html.

• cookies (array, optional): Cookies, die vor der Navigation eingefügt werden sollen. Akzeptiert das gleiche Format, das von browse_cookies zurückgegeben wird – verwenden Sie aus einem echten Browser exportierte Cookies, um auf authentifizierte Seiten zuzugreifen.

• stealth (boolean, optional): Zur Kompatibilität akzeptiert. Das Stealth-Verhalten wird vom Obscura-Server gesteuert.

browse_evaluate

Navigiert zu einer URL und führt JavaScript im Seitenkontext aus. Gibt das ausgewertete Ergebnis zurück.

Parameter:

• url (string, erforderlich): Die zu besuchende URL.

• expression (string, erforderlich): Der auszuwertende JavaScript-Ausdruck. Beispiele: document.title, navigator.userAgent, document.querySelector('h1').textContent.

• stealth (boolean, optional): Zur Kompatibilität akzeptiert.

browse_cookies

Navigiert zu einer URL und ruft alle von der Seite gesetzten Cookies ab. Gibt für jedes Cookie Name, Wert, Domain, Pfad und Ablaufdatum zurück.

Parameter:

• url (string, erforderlich): Die zu besuchende URL.

• stealth (boolean, optional): Zur Kompatibilität akzeptiert.

Konfiguration

Claude Desktop / Cline / Continue / Beliebiger MCP-Client

{
  "mcpServers": {
    "obscura-mcp": {
      "command": "obscura-mcp",
      "args": ["--transport", "stdio"]
    }
  }
}

VS Code (Cline-Erweiterung)

{
  "servers": {
    "obscura-mcp": {
      "command": "obscura-mcp",
      "args": ["--transport", "stdio"]
    }
  }
}

Nach der globalen npm-Installation befindet sich obscura-mcp in Ihrem PATH – absolute Pfade sind nicht erforderlich.

Umgebungsvariablen

Warum Obscura?

• Kein Chrome – reines Rust, kein 200 MB Browser-Bundle

• CDP-nativ – stellt das Chrome DevTools Protocol direkt bereit

• Anti-Erkennung – integrierter Stealth-Modus für Scraping-resistente Websites

• Winziger Speicherbedarf – ~15 MB Binärdatei, startet in Millisekunden

Lizenz

MIT