プロトタイプ · プレビュー版:公式レジストリのすべてのサーバーを掲載し、30分ごとに同期しています。Google でログインするとレビューを書けます。プロトタイプ · 30分ごとに更新
PopNx MCPAIを使う人のためのMCPサーバー · やさしい言葉で解説

Browserr

作者:Omodaka9375バージョン 0.9.2i★ 75iパソコンで動く公式サイト ↗
レジストリ名io.github.Omodaka9375/browserr

インストール方法

What it does

Fail-closed browser for agents: navigate, extract, fill forms, human handoff, evidence. No Chromium.

  • Connects パソコンで動く
  • Account or key No key needed
  • Category 文書・表計算・事務作業

一緒に使える

この種の作業を AI に教える Skill。これと一緒に使えます

MinerU

Transforms complex documents like PDFs and Office docs into LLM-ready markdown/JSON for your Agentic workflows.

作者:opendatalab★ 83,9191 個の skill

Skill · 手順書ライセンス記載なし

watermarks-remover

A privacy-first app that strips AI watermarks from content you own.

作者:guillaumemeyer★ 27,7231 個の skill

Skill · 手順書

obsidian-skills

Agent skills for Obsidian. Teach your agent to use Obsidian CLI and open formats including Markdown, Bases, JSON Canvas.

作者:kepano★ 53,104 (whole repo)5 個の skill

Skill · 手順書

この順位の理由

一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり

人気23/80GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます
新しさ12/1230 日以内のリリースかコード更新で満点
応答中0/8前回の確認でクラウドのエンドポイントが応答
利用スコア35/100

品質: 基本チェック 3/3 項目に合格(表示のみ、並び順には不使用) · 勢い: データなし (「急上昇」タブでのみ使用)

インストール

使っているAIアプリを選んで、設定をコピーしてください。

ひとことで AI にインストールしてもらう

Browserr をインストールして。https://mcp.popnx.com/i/omodaka9375-browserr.md に従い、コマンドを見せて、私が OK するまで実行しないで。

パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · AI が読む全文を見る

チェック 3/3 合格 · あなたのパソコンで動きます · ✓ コマンド確認済み 2026年11月19日

まず:どの AI を使っていますか?

使っているアプリを選ぶと、下に手順が表示されます。

Claude につなげますが、先に準備が必要です

先にパソコンへ Python (uv) を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません

AI にインストールしてもらう

このメッセージを Claude のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Claude に MCP server Browserr を入れてください。順番に:1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "browserr": { "command": "uvx", "args": [ "browserr-mcp" ] } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、Browserr のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. uv を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    uv --version
    • バージョン番号(例 uv …)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します

    uv のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: uv --version

    一度入れれば、uv を使うすべてのツールで使えます

  2. パソコン版 Claude アプリの設定ファイルを開く

    SettingsDeveloperEdit Config

  3. この設定を貼り付けて保存

    {
      "mcpServers": {
        "browserr": {
          "command": "uvx",
          "args": [
            "browserr-mcp"
          ]
        }
      }
    }
  4. Claude を終了してもう一度開く

  5. 試してみる

    Browserr を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude が Browserr を使っていると言うか、回答に Browserr のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

ChatGPT はまだ Browserr につなげません

Browserr はパソコンに入れて使うものですが、ChatGPT は Web 上で動くサーバーにしかつなげません

代わりにできること

A · Browserr につなげるアプリを使う

  • 先にパソコンへ Python (uv) を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません
  • 先にパソコンへ Python (uv) を入れてください(1 回だけ)
  • 先にパソコンへ Python (uv) を入れてください(1 回だけ)
  • 先にパソコンへ Python (uv) を入れてください(1 回だけ)

B · 文書・表計算・事務作業 の中で ChatGPT につなげる別のサーバー

同じカテゴリでよく使われているものから、キーなしでアドレスだけでつなげるものを選びました

Claude Code につなげますが、先に準備が必要です

先にパソコンへ Python (uv) を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを Claude Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Claude Code に MCP server Browserr を入れてください。順番に:1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):claude mcp add --scope user browserr -- uvx browserr-mcp 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、Browserr のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. uv を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    uv --version
    • バージョン番号(例 uv …)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します

    uv のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: uv --version

    一度入れれば、uv を使うすべてのツールで使えます

  2. ターミナルを開く

    Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く

  3. このコマンドを貼り付けて Enter

    claude mcp add --scope user browserr -- uvx browserr-mcp
  4. Claude Code で /mcp と入力

    Browserr が一覧にあり、接続済みと表示されれば OK です

  5. 試してみる

    Browserr を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude Code が Browserr を使っていると言うか、回答に Browserr のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Cursor につなげますが、先に準備が必要です

先にパソコンへ Python (uv) を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを Cursor のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Cursor に MCP server Browserr を入れてください。順番に:1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "browserr": { "command": "uvx", "args": [ "browserr-mcp" ] } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、Browserr のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. uv を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    uv --version
    • バージョン番号(例 uv …)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します

    uv のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: uv --version

    一度入れれば、uv を使うすべてのツールで使えます

  2. このボタンで Cursor を開く

    Cursor で開く

    Cursor がインストールの確認をするので Install を押します

  3. Cursor の AI チャットを Agent モードで開く

  4. 試してみる

    Browserr を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Cursor が Browserr を使っていると言うか、回答に Browserr のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

VS Code につなげますが、先に準備が必要です

先にパソコンへ Python (uv) を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを VS Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの VS Code に MCP server Browserr を入れてください。順番に:1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "servers": { "browserr": { "type": "stdio", "command": "uvx", "args": [ "browserr-mcp" ] } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、Browserr のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. uv を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    uv --version
    • バージョン番号(例 uv …)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します

    uv のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: uv --version

    一度入れれば、uv を使うすべてのツールで使えます

  2. このボタンで VS Code を開く

    VS Code で開く

    VS Code がインストールの確認をするので Install を押します

  3. VS Code の AI チャットを Agent モードで開く

  4. 試してみる

    Browserr を使って、私に何ができるか教えて、1 つやってみせて

    ✓ VS Code が Browserr を使っていると言うか、回答に Browserr のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください

MCP を使えるアプリをすべて見る →

JSON 設定は下の「開発者向け」にあります

つまずいたら?Browserr を使っている人に聞いてみましょう💬 ディスカッション →
開発者向け:ターミナルのコマンドと JSON 設定

パソコンにインストール

Claude Code

claude mcp add --scope user browserr -- uvx browserr-mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "browserr": {
      "command": "uvx",
      "args": [
        "browserr-mcp"
      ]
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "browserr": {
      "command": "uvx",
      "args": [
        "browserr-mcp"
      ]
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "browserr": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "browserr-mcp"
      ]
    }
  }
}

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

ひと目でわかる

週あたりのダウンロードi
npm/PyPIにない
接続方法
パソコンで動く
最新バージョンi
0.9.2
レジストリ公開日i
2026年11月18日
コードの最終更新i
2026年11月18日
作者
Omodaka9375
パッケージ
pypi: browserr-mcp
ウェブサイト
browserr.dev
レジストリでの状態
有効

使えるアプリ

このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。

パソコン上で動かせるアプリ

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

すべてのアプリと長所・短所 →

できること

パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月19日にチェック

  • ✓ 合格

    作者とリポジトリが一致

    レジストリ名は、リポジトリを所有するGitHubアカウント Omodaka9375 で確認済みです

  • ✓ 合格

    今もメンテナンスされている

    コードの最終更新:昨日

  • ✓ 合格

    ライセンスがある

    Apache-2.0を使用

  • – 対象外

    エンドポイントが応答する

    これはパソコンで動くため、インターネット上のエンドポイントはありません

  • – 対象外

    OAuthでサインイン

    パソコンで動き、代わりにローカルの設定を使います

  • … 未チェック

    ツールの説明に隠れた指示がない

    パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです

公開済みの脆弱性(OSV.dev)

まだ確認していません

確認していること → · JSON

作者の方へ:再確認の依頼・情報の誤りの報告
作者向け:README にバッジを付ける

作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/omodaka9375-browserr.svg)](https://mcp.popnx.com/en/servers/omodaka9375-browserr)

話し合い

質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。

まだ投稿はありません。最初の質問や共有をどうぞ。

ここの投稿は利用者によるもので、PopNx チームのものではありません。

ログインして投稿

ユーザーレビュー

まだレビューはありません

ログインしてレビューを書く

文書・表計算・事務作業のほかのサーバーとの比較i

  • このカテゴリのほかの4110件のうち98%よりスターが多い
  • このカテゴリのほかの4110件のうち99%より最近レジストリに公開
  • 基本チェックの結果が、このカテゴリのほかの4110件のうち99%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

Browserrは安全ですか?

当てはまる基本チェック3項目のうち3項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか?

レジストリには必須のキーは載っていません。ただし、最初に使うときにサインインを求めるサーバーもあります。

パソコンで動きますか、それともクラウドですか?

あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません(サーバー自体がオンラインサービスを呼び出す場合を除きます)。

今もメンテナンスされていますか?

GitHubリポジトリの最終更新は昨日、最新バージョン(0.9.2)がレジストリに届いたのは昨日です。

どのアプリで使えますか?

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにPython (uv)も必要です。

代わりに使えるものは?

同じカテゴリには:Puter MCP, XcodeBuildMCP, Vexa, Atlassian Rovo MCP Server, Anki MCP Server

似た働きのほかの候補

同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。

カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i

Puter MCP

Puter MCP enables AI tools to interact with Puter: manage files, websites, workers, and more

作者:HeyPuter広く使われている★ 4.4万5 か月前更新

クラウドで動く✓ 提供元 · puter.com

XcodeBuildMCP

XcodeBuildMCP provides tools for Xcode project management, simulator management, and app utilities.

作者:getsentry広く使われている↓ 13万/週 共有パッケージの数★ 65854 か月前更新

パソコンで動く✓ 提供元 · xcodebuildmcp.com

Vexa

Meeting bot and transcripts for Google Meet, Teams and Zoom. Live or after, speakers labelled.

作者:Vexa-ai広く使われている★ 29942 か月前更新

クラウドで動く✓ 提供元 · vexa.ai

Anki MCP Server

MCP server for Anki flashcards: adaptive review, notes, media, and deck management via AnkiConnect.

作者:ankimcp成長中↓ 1136/週★ 567先月更新

パソコンで動く✓ 提供元 · ankimcp.ai
似たものと比べる
これ
Browserr
Puter MCPXcodeBuildMCPVexaAtlassian Rovo MCP ServerAnki MCP Server
動く場所パソコンにインストールが必要クラウドで動き、インストール不要パソコンにインストールが必要クラウドで動き、インストール不要クラウドで動き、インストール不要パソコンにインストールが必要
キーが必要いいえいいえいいえはいいいえいいえ
Claude で + から追加いいえいいえいいえいいえはいいいえ
基本チェック3/34/43/32/44/43/3
ライセンスApache-2.0AGPL-3.0MITApache-2.0Apache-2.0MIT
料金登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

Browserr

A Servo-based browser engine built for AI agents. Headless by default, with an optional native interactive window for human handoff.

One Rust + Servo binary instead of embedding Chromium: it renders pages, blocks ads, and exposes a small loopback protocol built around three commitments: block when unsure, hand the page to a human when a human is needed, and leave evidence for everything it did.

Quickstart

Add it to any MCP-capable client (Claude Desktop, Kai, Cursor, ...) and you are done. The engine binary is downloaded and sha256-verified on first run:

{

"mcpServers": { "browserr": { "command": "uvx", "args": ["browserr-mcp"] } } }

42 tools: navigate, token-cheap reads, structured inventories with stable element refs, type-aware form filling, fail-closed interception, evidence capture, and human handoff. Python SDK and manual install: Install.

Why Browserr

Most agent browsers embed Chromium and speak CDP behind the scenes. Browserr is a purpose-built engine for the job instead, with the product decisions that follow from owning the whole stack:

  • Fail-closed by default. When Browserr is unsure, it blocks instead of guessing. Intercepted requests are held for a decision and denied after 5 s. Auth challenges with no stored credentials are refused outright. Submitting a payment or CAPTCHA page needs an explicit human confirm.
  • Humans are part of the workflow, not a fallback. detect_handoff() spots CAPTCHAs, one-time codes and payment fields. pause() hands the page to a person while the agent keeps watching; wait_for_user returns the moment control can come back. Annotated screenshots number every element, so a human and an agent can point at the same e7.
  • Every action leaves evidence. Timestamped screenshots plus an append-only action log, per profile. Credentials are stored per host and never written to logs, so a big claim is backed by a saved screenshot instead of a promise.
  • Runs where Chromium cannot. CPU rendering by default: instant start on GPU-less machines, containers, CI runners and a Raspberry Pi 4/5 (ARM64 builds included).
  • MCP-native, not wrapper-native. All 42 tools surface directly to any MCP-capable agent. No CDP quirks, no driver downloads, no version drift.
  • SPA-ready. Modern JS syntax, fetch/WebSockets/Workers, custom elements, shadow DOM, React 18 + Vue 3 verified rendering, plus IntersectionObserver, IndexedDB, Web Animations, WebGL2, crypto.subtle digests and requestIdleCallback (the last two via built-in shims where servo omits them).
  • Honest about its limits. Web compatibility is bounded by Servo 0.8: text, documents, search, forms and common SPA patterns work well; DRM video, WebRTC and service-worker-dependent offline apps do not. If you need those, or fleet scale or residential proxies, a cloud provider is still the better tool. Browserr wins on local, trust-first, human-in-the-loop work.

Features

Page engine
  • Servo 0.8 rendering, CPU by default (instant start on GPU-less machines, containers, CI); --gpu opts into hardware GL with automatic CPU fallback
  • SPA compatibility: React 18 and Vue 3 render and react; all modern ES syntax; fetch/WebSockets/Workers/custom elements/shadow DOM; IntersectionObserver, IndexedDB, Web Animations, WebGL and WebGL2 (via ANGLE, so it works on GPU-less machines too), clipboard and DecompressionStream; requestIdleCallback and crypto.subtle digests (SHA-1/256/384/512) via built-in shims where servo omits them
  • Tabs, navigation, per-tab history, zoom, pointer/wheel/keyboard input
  • JavaScript evaluation with results returned as JSON
  • On-demand screenshots of the active tab; the SDK saves them as PNG
  • Console capture: page messages plus network and TLS load errors
  • Downloads fetched straight to disk, without page cookies
  • EasyList-based adblock, refreshed weekly
Reading pages
  • read_page(): token-cheap prose extraction
  • read_structure(): every interactive element with its rect, selector and a stable ref (e7); fields carry label, constraints, state and validity; shadow DOM included. Refs are scoped to each read_structure() snapshot; after navigation or a refresh, read again. MCP reports stale refs as errors
Acting on pages
  • Selector interaction: click_element, set_value (React/Vue-safe), wait_for_selector
  • Ref interaction: click_ref, set_field, fill_form - stable refs, no selector fragility; a whole form in one round trip, with type-aware writes that fire input/change/blur once so page validators run
  • Submit cycle: submit_form runs the page's own validation, then read_outcome reports the url, alert texts and invalid fields
  • File uploads: picker events answered with local file paths
Network control
  • Fail-closed interception: requests are held for an allow / deny / respond decision; unanswered requests deny after 5 s
  • Net evidence: every fetch/XHR recorded in a ring buffer, in every frame
  • Auth challenges surface as events; wrong or missing credentials fail closed
  • Frame tree listing (cross-origin frames report their url only)
Human in the loop and trust
  • detect_handoff(): spots CAPTCHAs, one-time codes, empty passwords, payment fields and consent walls
  • pause() / resume(): mutating actions fail loudly while a human has control; reads keep working. MCP browser_wait_for_user completes only on navigation or an observed handoff clearing, never on a clean first scan
  • Real human handoff: browser_start({headed: true}) shows the native window; mouse and keyboard input still work while MCP actions are paused
  • Annotated screenshots: every element boxed and numbered by ref, so an agent and a human point at the same element
  • Persistent profiles: logins survive sessions
  • Evidence: timestamped screenshots plus an append-only action log; credentials are never logged
  • Credential store: auth challenges answered automatically for known hosts, denied for unknown ones
  • Confirm gate: submitting a payment or CAPTCHA page needs an explicit human confirm
Operations
  • ping health check; fast failure when the engine dies
  • Ephemeral throwaway profiles for per-run isolation
  • Concurrent driver clients over --driver-port, optional token authentication

Install

MCP clients: one command

The browserr-mcp package on PyPI installs the MCP server with a single config entry. The engine binary is downloaded from the official GitHub release and sha256-verified on first run (~46 MB, once); later starts are instant and offline: the resolved release tag is cached for 24 h and an installed engine never depends on a live GitHub API call.

{

"mcpServers": { "browserr": { "command": "uvx", "args": ["browserr-mcp"] } } }

(uv resolves the package; pip install browserr-mcp and command browserr-mcp work the same.) Pin a release with BROWSERR_VERSION, override the install dir with BROWSERR_HOME.

Manual: download the archive

Download the archive for your platform from releases and unpack it anywhere (no admin rights, no installer). You get:

engine(.exe)      the headless browser engine

libEGL.dll ANGLE GL for WebGL (Windows archives only) libGLESv2.dll must stay next to engine.exe driver.py Python SDK (stdlib only) browserr_mcp.py MCP server (stdlib only) mcp_wrap.cmd Windows MCP launcher (cmd wrapper) browserr-term terminal browser launcher (shell) browserr-term.cmd terminal browser launcher (Windows) browserr_term.py terminal browser UI (stdlib; numpy improves the fallback) update(.sh/.ps1/.cmd) in-place updater (see below) README.md, LICENSE

Requirements: Python 3.10+ on PATH. driver.py finds the engine binary next to itself; override with BROWSERR_ENGINE=/path/to/engine.

Linux runtime packages (all distros, headless included): the engine creates its GL context through EGL even for CPU (llvmpipe) rendering - EGL is the context-creation API, not the GPU. On a server/VPS without a GPU install:

sudo apt install libegl1 libgl1 libgbm1 libgl1-mesa-dri

(libegl1 + libgbm1 create the headless context, libgl1-mesa-dri ships llvmpipe, the software rasterizer. X11/xvfb is only needed for --headed; headless needs none of it.)

Update an existing unpack

Re-download the archive, or run the updater shipped inside it. It queries the GitHub API, verifies the download against the release's sha256 digest and refuses to install if the digest is missing or wrong (pass -AllowNoDigest / set ALLOW_NO_DIGEST=1 to override), backs up the current files, copies the new payload over this directory, and verifies the new binary before cleaning up. Stop a running engine first (a running executable cannot be replaced on Windows).

./update.sh                    # macOS / Linux: latest release

./update.sh v0.7.0 # pin a version update.cmd # Windows (double-clickable) powershell -File update.ps1 -WhatIf # report without touching anything

Android (Termux)

Browserr runs headless on Android inside Termux: the engine is an android-arm64 binary (API 29+ / Android 10+, 64-bit userland), and the MCP server and Python SDK run unmodified under Termux's Python 3. No APK, no root, no emulator needed - the same browserr-mcp package auto-detects Termux and downloads the android engine asset on first run.

pkg install python            # Python 3.12 from the Termux repo

pip install browserr-mcp # server + SDK + engine bootstrap browserr-mcp # first run downloads the android engine

Or drive it as a library, same as on a desktop:

import sys; sys.path.insert(0, "...")

from driver import Driver d = Driver(ephemeral=True) d.navigate("https://example.com/") print(d.read_page()[:200])

Headless only: no headed mode and no audio on Android. 32-bit ARM and x86 devices are not supported (no assets). Screenshot, eval, forms, network inspection - the full headless toolset works.

To test-drive a build manually (e.g. from an emulator or a rooted device) without pip, push the engine and drive it from the PC over adb forward:

adb push engine /data/local/tmp/engine

adb shell chmod +x /data/local/tmp/engine adb shell /data/local/tmp/engine --ephemeral --driver-port=7412 adb forward tcp:7412 tcp:7412

# from the PC, with the repo's tools/ on sys.path:

from driver import Driver d = Driver.attach(7412) d.navigate("https://example.com/") print(d.read_page()[:200])

Browse in your terminal

Browserr Term renders real pages inside a terminal pane at native resolution, using Sixel or the Kitty graphics protocol with dirty-rectangle patches computed in the engine. It needs no installer step:

https://github.com/user-attachments/assets/fdc5c347-2cf3-4fb7-b458-501d8e24506d

./browserr-term https://browserr.dev/        # macOS / Linux

browserr-term.cmd https://browserr.dev/ # Windows

Use a terminal with image support for native resolution (Windows Terminal 1.22+, iTerm2, wezterm, kitty, ghostty, mlterm; tmux works with `allow-passthrough

冒頭だけを表示しています。続きはリポジトリで読めます