Z
zy2755/browser-ref-mcp
A reliable browser-control MCP server for AI agents.
★ 1·更新 2026-11-17
在 GitHub 查看 ↗直链 · 无中转页
我们没有可直接复制的安装命令,也没有公开的远端端点,所以不出配置。上面那条命令仅供参考,不是我们能担保的可复制命令——编一条出来比不给更糟。 各客户端的接法 →
- ★ 数取值
- 1 ★ · zy2755/browser-ref-mcp · 取自 GitHub 搜索 API · (2026-11-19 20:00:48 核对)
- 来源明细
- 收录自 punkpeye/awesome-mcp-servers 榜单(我们从中收集的条目之一) · 条目类型:MCP 服务
- 收录与活跃
- 收录于 2026-11-18 · 最近见到 2026-11-20 · 共见到 3 次 · 被 3 个来源列出
- 评分构成
- 综合分 300 · 1 ★ · 3 个来源 · mcp
常见问题(答案都来自我们的记录)
它适合谁 / 用来做什么?
我们把它归在这些标签下: MCP 服务。标签来自条目自身,不是我们强加的分类。
谁维护它、还在更新吗?
仓库
zy2755/browser-ref-mcp;我们收录于 2026-11-18;最近见到 2026-11-20。这里没有"官方认证"或"质量评级"——我们只记录来源与时间。README 原文(英文,未翻译) · 在 GitHub 读完整 README →
# browser-ref-mcp
以下摘录自该仓库的 README(片段)
A reliable browser-control MCP server for AI agents. Click by ref, not by brittle CSS selectors — and when the browser dies, the next call just brings it back.
Built for the two things that actually break agent-driven browsing:
| The problem | What happens with most browser tools | What this server does |
| The agent can't click what it sees | Selectors go stale between snapshot and click, shadow DOM and cross-origin iframes are invisible, the agent retries blindly | Semantic snapshot with [eN] refs, shadow DOM and cross-origin iframes flattened into one tree, four-level resolution fallback |
| Sessions keep dying | Browser closed by hand, process crash, port conflict — and the agent is stuck until you restart everything | Resident process, lazy restart on next call, tab session restored, orphan cleanup, timeout guardrails |
No browser download. It drives the Chrome or Edge you already have, via playwright-core.
Works with Claude Code, Claude Desktop, Cursor, Cline, Codex CLI, Windsurf, OpenClaw, and any client that speaks stdio MCP.
## Quick start
### Claude Code
/plugin install browser-ref-mcp --marketplace zy2755/browser-ref-mcp
One line installs the server plus a short skill that tells Claude when to reach for the browser and what to do when a ref goes stale.
### LobeHub Skills marketplace
bash
npx -y @lobehub/market-cli skills install zy2755-browser-ref-mcp-browser-control --agent claude-code
Also listed as an MCP server at lobehub.com/mcp/zy2755-browser-ref-mcp.
### Where else it's listed
punkpeye/awesome-mcp-servers — listed under "Web content access and automation"
mcpservers.org — directory listing with install and config walkthroughs
Glama — rated A for tool definitions, all 14 tools indexed
cursor.directory — Cursor plugin directory
### Any other client
bash
npx -y browser-ref-mcp
Or add it to your client config:
json
"mcpServers": {
"browser-ref-mcp": {
"command": "npx",
"args": ["-y", "browser-ref-mcp"]
Restart the client completely (on macOS quit from the menu bar — closing the window does not reload config).
Install from source instead
bash
git clone https://github.com/zy2755/browser-ref-mcp.git
cd browser-ref-mcp
npm install && npm run build
Then point command at node and args at the absolute path of dist/index.js — GUI apps often don't inherit your shell's working directory, so relative paths tend to fail:
json
"mcpServers": {
"browser-ref-mcp": {
"command": "node",
"args": ["/absolute/path/to/browser-ref-mcp/dist/index.js"]
Config file locations:
Claude Desktop — macOS: ~/Library/Application Support/Claude/claude_desktop_config.json, Windows: %APPDATA%\Claude\claude_desktop_config.json
Cursor — ~/.cursor/mcp.json, or Settings → Features → MCP
Claude Code — claude mcp add, or the same mcpServers shape
## The 14 tools
| Tool | What it does |
| browser_navigate(url) | Navigate — automatically returns an interactive-element snapshot |
| browser_snapshot | Semantic snapshot. filter: "interactive" for interactive elements only, rootRef to scope to one subtree |
| browser_click(ref) | Click by ref, returns a fresh snapshot. Stale refs are re-resolved automatically |
| browser_type(ref, text) | Type into a field (clears first). submit: true presses Enter |
Built for the two things that actually break agent-driven browsing:
| The problem | What happens with most browser tools | What this server does |
| The agent can't click what it sees | Selectors go stale between snapshot and click, shadow DOM and cross-origin iframes are invisible, the agent retries blindly | Semantic snapshot with [eN] refs, shadow DOM and cross-origin iframes flattened into one tree, four-level resolution fallback |
| Sessions keep dying | Browser closed by hand, process crash, port conflict — and the agent is stuck until you restart everything | Resident process, lazy restart on next call, tab session restored, orphan cleanup, timeout guardrails |
No browser download. It drives the Chrome or Edge you already have, via playwright-core.
Works with Claude Code, Claude Desktop, Cursor, Cline, Codex CLI, Windsurf, OpenClaw, and any client that speaks stdio MCP.
## Quick start
### Claude Code
/plugin install browser-ref-mcp --marketplace zy2755/browser-ref-mcp
One line installs the server plus a short skill that tells Claude when to reach for the browser and what to do when a ref goes stale.
### LobeHub Skills marketplace
bash
npx -y @lobehub/market-cli skills install zy2755-browser-ref-mcp-browser-control --agent claude-code
Also listed as an MCP server at lobehub.com/mcp/zy2755-browser-ref-mcp.
### Where else it's listed
punkpeye/awesome-mcp-servers — listed under "Web content access and automation"
mcpservers.org — directory listing with install and config walkthroughs
Glama — rated A for tool definitions, all 14 tools indexed
cursor.directory — Cursor plugin directory
### Any other client
bash
npx -y browser-ref-mcp
Or add it to your client config:
json
"mcpServers": {
"browser-ref-mcp": {
"command": "npx",
"args": ["-y", "browser-ref-mcp"]
Restart the client completely (on macOS quit from the menu bar — closing the window does not reload config).
Install from source instead
bash
git clone https://github.com/zy2755/browser-ref-mcp.git
cd browser-ref-mcp
npm install && npm run build
Then point command at node and args at the absolute path of dist/index.js — GUI apps often don't inherit your shell's working directory, so relative paths tend to fail:
json
"mcpServers": {
"browser-ref-mcp": {
"command": "node",
"args": ["/absolute/path/to/browser-ref-mcp/dist/index.js"]
Config file locations:
Claude Desktop — macOS: ~/Library/Application Support/Claude/claude_desktop_config.json, Windows: %APPDATA%\Claude\claude_desktop_config.json
Cursor — ~/.cursor/mcp.json, or Settings → Features → MCP
Claude Code — claude mcp add, or the same mcpServers shape
## The 14 tools
| Tool | What it does |
| browser_navigate(url) | Navigate — automatically returns an interactive-element snapshot |
| browser_snapshot | Semantic snapshot. filter: "interactive" for interactive elements only, rootRef to scope to one subtree |
| browser_click(ref) | Click by ref, returns a fresh snapshot. Stale refs are re-resolved automatically |
| browser_type(ref, text) | Type into a field (clears first). submit: true presses Enter |
收录徽章(可选)
想把收录标记放进 README 就复制这行,可选,不影响收录。
[](https://anclum.com/zh/s/zy2755-browser-ref-mcp/)
- 来源
- awesome · https://github.com/zy2755/browser-ref-mcp
- 按领域浏览
- MCP 服务
- Traction
- 1 ★
- 收录来源
- 3 个独立来源
- 收录于
- 今天
更多 MCP 服务器
所属领域与标签
每个标签都能点进去看同类的全部条目。数字是当前库里的真实条数。