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 的三大支柱

这三项永远不会合并成一个分数：意见、测量和人气是不同的东西。

用户评价i暂无评价评价功能将在后续阶段与账户功能一起开放
我们的基础检查i1 项中通过 1 项依据公开信息检查；尚未扫描代码
使用情况i非常新↓ 71/周 · ★ –

它能帮你做什么

我们还没有为它写通俗的介绍。下面是我们从注册中心读取到的事实。

连接方式: 在你的电脑上运行
传输方式: stdio
分类: 网页与浏览器
你需要填写：AETHYN_PASSWORD

安装

选择你使用的 AI 应用，然后复制设置。

安装之前

基础检查：1 项中通过 1 项
在你的电脑上运行，拥有你的用户账户的权限（文件、网络、应用）。
需要你自己填写： AETHYN_USERNAME, AETHYN_PASSWORD, AETHYN_DEFAULT_TIER

标为机密的值是你账户的钥匙。千万不要分享给别人，也不要粘贴到聊天里。

你需要

npm已安装 Node.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月9日

✓ 通过
作者与仓库一致
注册名称已通过 GitHub 账户 aethynio 验证，该账户拥有此仓库
… 尚未检查
仍在维护
我们还没有从 GitHub 读取这个仓库
… 尚未检查
有许可证
我们还没有从 GitHub 读取这个仓库
– 不适用
端点有响应
它在你的电脑上运行，没有互联网端点
– 不适用
使用 OAuth 登录
在你的电脑上运行，改用本地设置
… 尚未检查
工具描述中没有隐藏指令
它在你的电脑上运行；我们只能读取互联网端点的工具列表

与“网页与浏览器”中的其他服务器比较i

星标数多于此分类中其他 1391 个服务器的 0%
发布到注册中心的时间比此分类中其他 1391 个服务器的 16% 更新
基础检查结果等于或优于此分类中其他 1391 个服务器的 100%

与注册中心里这个分类中所有活跃的服务器比较。只有当发布者拥有该仓库时，星标数才计入。

常见问题

Aethyn Browser MCP 安全吗？

它在 1 项适用的基础检查中通过了 1 项。我们没有阅读代码。在添加密钥或令牌之前，请先看看这个服务器要求哪些权限，并使用只具备所需权限的密钥。

它需要哪些密钥或代码？

你需要填写：AETHYN_PASSWORD

它在我的电脑上运行还是在云端？

它在你的电脑上运行。你的 AI 应用会在需要时启动它，数据不会经过作者的服务器（除非它自己调用在线服务）。

它还在维护吗？

GitHub 仓库最后更新于–，最新版本（0.1.1）于4个月前进入注册中心。

哪些应用可以使用它？

支持 MCP 的应用，例如 Claude Desktop、Claude Code、Cursor 和 VS Code。你的电脑上还需要有 Node.js。

有什么可以替代它？

同一分类中有：Browser Use, Chrome DevTools MCP, MCP Server Browser

替代选择

同一分类中其他作者的服务器，按星标数排序。

如何看卡片：↓ 每周下载量i★ GitHub 星标i三大支柱：评价 · 检查 · 使用情况i更新 = 最新版本发布到注册中心的时间i

Browser Use

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

作者：browser-use广泛使用↓ 155.2万/周★ 12万19天前更新

电脑或云端✓ 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.