ZenLink MCP
通过ZenLink实现浏览器自动化的MCP服务器——通过Zen浏览器(基于Firefox)为Claude Desktop和其他MCP客户端提供原生浏览器控制。
安装```bash
pip install zenlink-mcp
## 需求
- ZenLink浏览器扩展 安装在Zen浏览器中
- ZenLink桥运行(`python native/bridge.py`)
## 工具
|工具|说明|
|------|-------------|
| `zen_status` |检查ZenLink网桥和扩展是否已连接|
| `zen_navigate` |导航到URL|
| `zen_page_text` |从当前页面提取所有可读文本|
| `zen_page_info` |获取页面URL、标题、尺寸、滚动位置|
| `zen_tabs` |列出所有打开的浏览器选项卡|
| `zen_new_tab` |打开新选项卡|
| `zen_close_tab` |按ID关闭选项卡|
| `zen_switch_tab` |按ID切换到选项卡|
| `zen_click` |通过CSS选择器或坐标单击元素|
| `zen_type` |在输入框中键入文本|
| `zen_fill` |直接设置表单字段值(比键入更快)|
| `zen_scroll` |滚动页面|
| `zen_hover` |将鼠标悬停在元素上|
| `zen_find` |使用自然语言查找元素|
| `zen_js` |在页面上下文中执行JavaScript|
| `zen_highlight` |用视觉叠加突出显示元素|
| `zen_screenshot` |截图|
| `zen_dom` |获取交互元素的可访问性树|
| `zen_forms` |获取所有带有标签和值的表单字段|
| `zen_wait_for_element` |等待CSS选择器出现(替换固定睡眠定时器)|
| `zen_wp_html` |从WordPress Elementor页面提取HTML小部件内容|
| `zen_batch` |在单个速度请求中运行多个命令|
### `zen_wait_for_element`
等待CSS选择器出现并在页面上可见。找到后立即返回,而不是在固定时间内休眠——使用此选项代替 `sleep` 当等待动态/JS渲染的内容时。```json
{"action": "waitForElement", "selector": ".tracking-events", "timeout": 10000}
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
selector |
string | 必需 | 要等待的CSS选择器 |
timeout |
int | 10000 | 最大等待时间(毫秒) |
poll_interval |
int | 200 | 检查的频率(毫秒) |
退货 { ok: true, found: true, elapsed: 342, ref: "r12", tag: "div" } 关于成功,或 { ok: false, found: false, error: "Timed out after 10000ms" } 超时。
zen_batch
在一个请求中运行多个命令。支持所有操作,包括 waitForElement 和 sleep:```json
[
{"action": "navigate", "url": "https://example.com"},
{"action": "waitForElement", "selector": ".results", "timeout": 8000},
{"action": "pageText"}
]
## Claude桌面设置
添加到您的 `claude_desktop_config.json`:```json
{
"mcpServers": {
"zenlink": {
"command": "zenlink-mcp"
}
}
}
更新日志
1.1.0
- 添加
zen_wait_for_elementtool——轮询DOM,直到选择器出现,而不是固定的睡眠定时器 - 添加
waitForElement作为批处理操作 - 桥梁:新建
/api/wait-for-element具有自动延长超时的端点 - 内容脚本升级到v6
1.0.3
- 首次公开发布
链接
- ZenLink大桥和扩建
- MCP注册表
