cyberranger93/mcp-browser
GitHub: cyberranger93/mcp-browser
基于 Playwright 和 MCP 协议的隐身浏览器工具，为 AI 代理提供反检测的网页自动化交互能力。
Stars: 0 | Forks: 0
# mcp-browser
[](https://npmjs.com/package/mcp-browser)
[](https://github.com/cyberranger93/mcp-browser/actions/workflows/ci.yml)
[](LICENSE)
`mcp-browser` 为 Claude Desktop、Cursor 及其他兼容 MCP 的代理提供了一个真实的 Playwright 浏览器，包含用于导航、页面文本提取、屏幕截图、表单交互和网络响应捕获的简单工具。
它专为经过授权的 QA、研究、内部工具以及无法使用 API 的代理工作流而构建。对于公开发布，核心招聘信号是 MCP 接口设计、浏览器生命周期管理和具备防护机制的执行模型。
## 快速开始
```
git clone https://github.com/cyberranger93/mcp-browser.git
cd mcp-browser
npm install
npm run build
node dist/index.js
```
## Claude Desktop 设置
将以下内容添加到 `claude_desktop_config.json` 中：
```
{
"mcpServers": {
"browser": {
"command": "npx",
"args": ["github:cyberranger93/mcp-browser"]
}
}
}
```
重启 Claude Desktop，然后要求它进行导航、检查页面文本、截取屏幕截图或总结网络响应。
## 可选的源站允许列表
对于受控环境，可以将导航限制在已知的源站：
```
$env:MCP_BROWSER_ALLOWED_ORIGINS = "https://example.com,https://docs.example.com"
node dist/index.js
```
如果未设置允许列表，`mcp-browser` 将允许 HTTP 和 HTTPS 导航。非 Web 协议将被始终拒绝。
## 工具
| 工具 | 描述 |
|---|---|
| `navigate` | 打开 URL 并返回标题、最终 URL 和状态 |
| `get_page_text` | 返回当前页面的可见文本 |
| `find_element` | 通过 CSS 选择器定位元素 |
| `click` | 点击第一个匹配的元素 |
| `fill_form` | 填写 input 或 textarea |
| `take_screenshot` | 返回 PNG 屏幕截图 |
| `get_network_requests` | 返回最近的网络响应 |
| `close_browser` | 关闭浏览器进程 |
## 为什么会有这个项目
代理浏览器工具通常只停留在“打开页面并抓取文本”的层面。实用的生产工作流需要更多功能：
| 功能 | mcp-browser | 基础浏览器封装 |
|---|---|---|
| MCP 原生工具接口 | 是 | 混合 |
| 屏幕截图返回路径 | 是 | 混合 |
| 网络响应追踪 | 是 | 罕见 |
| 可选的源站允许列表 | 是 | 罕见 |
| 一条命令本地运行 | 是 | 混合 |
## 代理工作流示例
```
User: Check the docs page and tell me whether the pricing table loaded.
Agent:
1. navigate("https://example.com/pricing")
2. get_page_text()
3. get_network_requests()
4. take_screenshot()
5. answers with the page state and supporting evidence
```
## 安全性
仅在你拥有自动化浏览权限的场景下使用此工具。请尊重网站条款、robots 协议、速率限制和账户边界。允许列表的存在是为了让团队能够将代理的浏览范围限制在已获批准的域名内。
## 路线图
- [ ] DOM 可访问性快照工具
- [ ] 每个工具的超时设置和最大截图大小控制
- [ ] 针对网络和元素结果的 JSON schema 输出
- [ ] 带有固定 Playwright 浏览器的 Docker 镜像
- [ ] 演示 GIF 和发布视频
## 贡献
欢迎提交 PR。详情请参阅 [CONTRIBUTING.md](CONTRIBUTING.md)。
## 许可证
MIT
标签：AI智能体, Claude Desktop, Cursor, DNS 解析, GNU通用公共许可证, MCP工具, MITM代理, Node.js, Playwright, RPA, Web自动化, 反机器人, 反检测浏览器, 后渗透, 大模型工具, 密码管理, 无头浏览器, 暗色界面, 模型上下文协议, 浏览器指纹伪装, 浏览器自动化, 特征检测, 网络安全, 自动化代理, 自动化攻击, 自动化浏览器, 表单自动化, 身份伪装, 隐私保护, 隐蔽浏览器