Aethyn Browser MCP

Name: Aethyn Browser MCP
Author: aethynio

作者：aethynioバージョン 0.1.1i★ –iパソコンで動く

レジストリ名io.github.aethynio/aethyn-browser-mcp

インストール

概要

作者による説明（英語の原文）

Local Playwright browser through residential proxies — agent picks country + sticky identity

PopNx MCPの3つの柱

この3つを1つのスコアにまとめることはしません。意見、測定、人気はそれぞれ別のものだからです。

利用者の声iレビューはまだありませんレビューは今後のステップで、アカウント機能と一緒に始まります
私たちの基本チェックi1項目中1項目に合格公開情報からチェック。コードはまだスキャンしていません
利用状況iとても新しい↓ 71/週 · ★ –

できること

このサーバーのやさしい解説はまだ書いていません。以下はレジストリから読み取った事実です。

接続方法: パソコンで動く
トランスポート: stdio
カテゴリ: ウェブ・ブラウザ
入力が必要なもの：AETHYN_PASSWORD

インストール

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

インストールの前に

基本チェック：1項目中1項目に合格
あなたのパソコンで、あなたのユーザーと同じ権限（ファイル、ネットワーク、アプリ）で動きます。
自分で入力するもの： AETHYN_USERNAME, AETHYN_PASSWORD, AETHYN_DEFAULT_TIER

「秘密」と表示された値は、あなたのアカウントの鍵です。絶対に人に教えたり、チャットに貼り付けたりしないでください。

必要なもの

npmNode.jsのインストール（npxコマンドに必要）

どのアプリを使っていますか？

ClaudeClaude CodeCursorVS CodeChatGPT

上でアプリを選んでください。選んだアプリを覚えておくので、次からはボタンに「…にインストール」と表示されます。

Claude Desktop → Settings → Developer → Edit Config を開き、claude_desktop_config.json にこれを貼り付けます

{
  "mcpServers": {
    "aethyn-browser": {
      "command": "npx",
      "args": [
        "-y",
        "aethyn-browser-mcp"
      ],
      "env": {
        "AETHYN_USERNAME": "your-value",
        "AETHYN_PASSWORD": "your-value",
        "AETHYN_DEFAULT_TIER": "your-value"
      }
    }
  }
}

ターミナルでこれを実行します

claude mcp add aethyn-browser --env AETHYN_USERNAME=your-value --env AETHYN_PASSWORD=your-value --env AETHYN_DEFAULT_TIER=your-value -- npx -y aethyn-browser-mcp

動かす前に、空欄の値を入力してください。

Cursorで開く

または、設定を自分でコピーする

プロジェクトの .cursor/mcp.json、または ~/.cursor/mcp.json に貼り付けます

{
  "mcpServers": {
    "aethyn-browser": {
      "command": "npx",
      "args": [
        "-y",
        "aethyn-browser-mcp"
      ],
      "env": {
        "AETHYN_USERNAME": "your-value",
        "AETHYN_PASSWORD": "your-value",
        "AETHYN_DEFAULT_TIER": "your-value"
      }
    }
  }
}

ブラウザがアプリを開いてよいか確認し、そのあとアプリが設定を表示して確認を求めます。キーの値は空欄のままなので、自分で入力してください。

VS Codeで開く

または、設定を自分でコピーする

プロジェクトの .vscode/mcp.json に貼り付けます

{
  "servers": {
    "aethyn-browser": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "aethyn-browser-mcp"
      ],
      "env": {
        "AETHYN_USERNAME": "your-value",
        "AETHYN_PASSWORD": "your-value",
        "AETHYN_DEFAULT_TIER": "your-value"
      }
    }
  }
}

これはパソコンで動くサーバーですが、ChatGPTがつなげるのはインターネット上のサーバーだけです。ほかのアプリを選んでください。

選んだアプリは、この端末のCookieに保存されます。アカウントは不要です。

自分で入力する値

AETHYN_USERNAME env
Aethyn proxy username (e.g. aethyn-XXXXX). Omit if using a custom proxy via PROXY_*.
AETHYN_PASSWORD 秘密 env
Aethyn proxy password (or PROXY_PASSWORD for a custom proxy).
AETHYN_DEFAULT_TIER env
Default proxy tier: premium (port 2099) or elite (port 5499).

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

できること

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

基本チェックi

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

✓ 合格
作者とリポジトリが一致
レジストリ名は、リポジトリを所有するGitHubアカウント aethynio で確認済みです
… 未チェック
今もメンテナンスされている
このリポジトリはまだGitHubから読み取っていません
… 未チェック
ライセンスがある
このリポジトリはまだGitHubから読み取っていません
– 対象外
エンドポイントが応答する
これはパソコンで動くため、インターネット上のエンドポイントはありません
– 対象外
OAuthでサインイン
パソコンで動き、代わりにローカルの設定を使います
… 未チェック
ツールの説明に隠れた指示がない
パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです

ウェブ・ブラウザのほかのサーバーとの比較i

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

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

よくある質問

Aethyn Browser MCPは安全ですか？

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

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

入力が必要なもの：AETHYN_PASSWORD

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

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

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

GitHubリポジトリの最終更新は–、最新バージョン（0.1.1）がレジストリに届いたのは4 か月前です。

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

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

代わりに使えるものは？

同じカテゴリには：Browser Use, Chrome DevTools MCP, MCP Server Browser

代わりの候補

同じカテゴリで、ほかの作者が作ったサーバー。スターの多い順。

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

Browser Use

Browser agents and stealth cloud browsers for AI: run web tasks, fill forms, extract data.

作者：browser-use広く使われている↓ 155.2万/週★ 12万18 日前更新

パソコンでもクラウドでも✓ browser-use.com

インストール

Chrome DevTools MCP

MCP server for Chrome DevTools

作者：ChromeDevTools広く使われている↓ 188.4万/週★ 5.5万17 日前更新

パソコンで動く

インストール

MCP Server Browser

MCP server for browser use access

作者：bytedance広く使われている↓ 792/週★ 4万14 か月前更新

パソコンで動く

インストール

作者のREADME

READMEを開く

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

Aethyn Browser MCP — residential-proxy browser control for AI agents (pick the country, one identity per task)

An MCP server that lets an AI agent drive a real browser through residential proxies, choosing the exit country / city, tier, and a sticky per-task session — at call time. The browser (Playwright Chromium) runs locally on your machine; you bring your own proxy credentials. Defaults to Aethyn residential proxies, and works with any HTTP proxy you configure.

The only browser MCP where the agent picks the country and holds one identity per task.

Why this exists

Playwright MCP drives a browser well, but its proxy is set once at server startup — one static exit for the whole session. The agent can't ask for a Japanese exit for one task and a German exit for the next.
Hosted "web scraping" MCPs hide the proxy and hand back JSON — no runtime control over geo or session identity, and it's their pool at their price.

This server gives the agent runtime, per-task, steerable geo + sticky identity as tools — exactly what browser agents need to pull country-specific data (pricing, SERPs, catalogs, availability) and feed it into a chart or pipeline.

Quickstart

Add the server to your MCP client — Claude Desktop (claude_desktop_config.json) or Cursor (~/.cursor/mcp.json):

"mcpServers": { "aethyn-browser": { "command": "npx", "args": ["-y", "aethyn-browser-mcp"], "env": { "AETHYN_USERNAME": "aethyn-XXXXX", "AETHYN_PASSWORD": "your-proxy-password", "AETHYN_DEFAULT_TIER": "premium" } } } }

Chromium is downloaded automatically on first install (~170 MB, one-time). If your environment blocks post-install scripts, run it yourself: npx playwright install chromium.

⚠️ Set the tier to match your plan. AETHYN_DEFAULT_TIER defaults to premium (port 2099). If your account is Elite, set it to elite (port 5499) — otherwise traffic hits the Premium port and the proxy returns 407 (auth rejected), even though the browser launched fine. The agent can also override per task with tier: "elite".

That's it. Ask your agent something like *"Launch a browser in Japan, open example.co.jp, verify the exit IP is Japanese, and give me the page as markdown."*

Tools

Tool	What it does
`aethyn_launch_browser`	Launch local Chromium through a residential exit in a chosen `country` (+ `city`/`state` on Elite), `tier`, and sticky `session`. Returns a `session_id`.
`aethyn_navigate`	Go to a URL; waits for load and returns the HTTP status, final URL, and title.
`aethyn_get_content`	Return the page cleaned for reading (`markdown` / `text` / `html`).
`aethyn_snapshot`	Accessibility snapshot (roles, names, `[ref=..]` handles) — how the agent decides what to click.
`aethyn_click`	Click by `ref` (from the snapshot) or a CSS/role/text `selector`.
`aethyn_type`	Type into an input (optionally submit with Enter).
`aethyn_check_exit_ip`	Fetch IP info through the session's proxy to verify the geo actually landed.
`aethyn_new_identity`	Rotate to a fresh exit IP (same country) and clear cookies.
`aethyn_close`	Close the session's context and free memory.
`aethyn_list_countries`	Discover available countries (and Elite cities) at runtime.

How it's different

	Aethyn Browser MCP	Playwright MCP	Hosted scraping MCPs
Runs the browser	Local (yours)	Local	Their cloud
Proxy geo chosen by the agent per task	✅ at call time	❌ fixed at startup	❌ not exposed
Sticky identity per task (pinned exit IP)	✅	❌	❌
Verify the exit geo landed	✅ `check_exit_ip`	❌	❌
Bring your own proxy	✅ any HTTP proxy	one static proxy	❌

No trash-talk — just the capability delta. (Playwright MCP is great; it just wasn't built for per-task geo.)

Bring your own proxy

Aethyn is the default, but any HTTP proxy works — point PROXY_HOST at it and describe its username format with a template. [ ... ] segments are dropped when empty, and {country} {city} {state} {session} {lifetime} are filled from the agent's call:

"mcpServers": { "browser": { "command": "npx", "args": ["-y", "aethyn-browser-mcp"], "env": { "PROXY_HOST": "gate.your-provider.com", "PROXY_PORT": "7000", "PROXY_USERNAME": "your-user", "PROXY_PASSWORD": "your-pass", "PROXY_USERNAME_TEMPLATE": "{username}-country-{country}[-city-{city}]-session-{session}-lifetime-{lifetime}" } } } }

For a plain fixed proxy with no geo in the username, use "PROXY_USERNAME_TEMPLATE": "{username}".

Configuration

Env var	Default	Notes
`AETHYN_USERNAME` / `AETHYN_PASSWORD`	—	Your Aethyn proxy credentials (default provider).
`AETHYN_DEFAULT_TIER`	`premium`	`premium` (HTTP `2099`) or `elite` (HTTP `5499`, unlocks city/state).
`AETHYN_HEADLESS`	`true`	Set `false` to watch the browser.
`AETHYN_MAX_SESSIONS`	`8`	Oldest session is evicted past this cap.
`AETHYN_IDLE_TIMEOUT_MIN`	`10`	Idle sessions auto-close after this many minutes.
`AETHYN_IPINFO_URL`	`https://ipinfo.io/json`	Endpoint `check_exit_ip` hits (through the proxy).
`PROXY_HOST` / `PROXY_PORT` / `PROXY_USERNAME` / `PROXY_PASSWORD` / `PROXY_USERNAME_TEMPLATE`	—	Bring-your-own proxy (overrides the Aethyn default).

HTTP proxies only — Chromium can't authenticate SOCKS5, so this server is HTTP-only by design.

Guardrails

This tool is for collecting public data. Please:

Respect robots.txt, rate limits, and each site's terms and the law. *Can reach ≠ should.*
No login/credential-wall automation, and no CAPTCHA solving — there's no such capability. If a site shows a challenge, read the page and stop rather than trying to bypass it.
Pace yourself. A residential IP firing dozens of requests per second is still obviously a bot.
Your credentials stay in your MCP config on your machine; the proxy password is never logged.

Get credentials

Need residential proxy credentials? The free trial needs no card:

[→ Create an Aethyn account](https://www.aethyn.io/signup?utm_source=github&utm_medium=referral&utm_campaign=browser-mcp&utm_content=readme-cta) · Quickstart docs · Pricing

Contributing

PRs welcome — especially extending [`data/locations.json`](./data/locations.json) with more countries, cities, and states (single lowercase alphanumeric tokens), and new client examples. Keep it real and runnable; use placeholder credentials only.

License

MIT — free to use, copy, and adapt.

Aethyn Browser MCP

概要

PopNx MCPの3つの柱

できること

インストール

インストールの前に

自分で入力する値

できること

基本チェックi

作者とリポジトリが一致

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

ライセンスがある

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

OAuthでサインイン

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

ウェブ・ブラウザのほかのサーバーとの比較i

よくある質問

代わりの候補

Browser Use

Chrome DevTools MCP

MCP Server Browser

作者のREADME

Aethyn Browser MCP — residential-proxy browser control for AI agents (pick the country, one identity per task)

Why this exists

Quickstart

Tools

How it's different

Bring your own proxy

Configuration

Guardrails

Get credentials

Contributing

License