obscura-mcp

スクレイピングおよびAIエージェント自動化のための軽量Rust製ヘッドレスブラウザ、Obscura用のMCPサーバーアダプターです。

ObscuraのネイティブなCDP機能をクリーンなMCPインターフェースを通じて公開します。Chromeへの依存や、重量級のブラウザ自動化ツールは不要です。

インストール

npm install -g obscura-mcp

インストールは一瞬で完了します。ブラウザバイナリ（約80MB）は初回使用時に遅延ダウンロードされます。

インストール後、以下のいずれかを行ってください：

• obscura-mcp install を実行して、進捗状況を表示しながらバイナリをダウンロードする。

• 単に obscura-mcp を実行する。自動的にバイナリがダウンロードされ、サーバーが起動します。

バイナリは ~/.obscura/bin/ にキャッシュされ、npmのアップグレード後も保持されます。

カスタムバイナリパスを使用する場合：

export OBSCURA_PATH=/path/to/obscura

Related MCP server: Algonius Browser

クイックスタート

# Install
npm install -g obscura-mcp

# Verify
obscura-mcp --version

# Download browser binary
obscura-mcp install

# Start MCP server
obscura-mcp --transport stdio

ツール

browse_url

ObscuraのCDPエンジンを使用してURLを取得します。ページコンテンツを返します。

パラメータ:

• url (string, 必須): アクセスするHTTPまたはHTTPS URL。

• dump (string, 任意): html、text、または links。デフォルトは html です。

• cookies (array, 任意): ナビゲーション前に注入するCookie。browse_cookies が返すものと同じ形式を受け入れます。実際のブラウザからエクスポートしたCookieを渡すことで、認証が必要なページにアクセスできます。

• stealth (boolean, 任意): 互換性のために受け入れられます。ステルス動作はObscuraサーバーによって制御されます。

browse_evaluate

URLに移動し、ページコンテキストでJavaScriptを実行します。評価結果を返します。

パラメータ:

• url (string, 必須): アクセスするURL。

• expression (string, 必須): 評価するJavaScript式。例: document.title, navigator.userAgent, document.querySelector('h1').textContent。

• stealth (boolean, 任意): 互換性のために受け入れられます。

browse_cookies

URLに移動し、ページによって設定されたすべてのCookieを取得します。各Cookieの名前、値、ドメイン、パス、有効期限を返します。

パラメータ:

• url (string, 必須): アクセスするURL。

• stealth (boolean, 任意): 互換性のために受け入れられます。

設定

Claude Desktop / Cline / Continue / その他のMCPクライアント

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

VS Code (Cline拡張機能)

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

グローバルなnpmインストール後、obscura-mcp はPATHに含まれるため、絶対パスは不要です。

環境変数

なぜObscuraなのか？

• Chrome不要 — 純粋なRust製、200MBのブラウザバンドルは不要

• CDPネイティブ — Chrome DevTools Protocolを直接公開

• 検知回避 — スクレイピング対策サイト向けのステルス機能を内蔵

• 超軽量 — 約15MBのバイナリ、ミリ秒単位で起動

ライセンス

MIT