ZenLink MCP
通过ZenLink实现浏览器自动化的MCP服务器——通过Zen浏览器（基于Firefox）为Claude Desktop和其他MCP客户端提供原生浏览器控制。
安装
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渲染的内容时。
{"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:
[
{"action": "navigate", "url": "https://example.com"},
{"action": "waitForElement", "selector": ".results", "timeout": 8000},
{"action": "pageText"}
]Claude桌面设置
添加到您的 claude_desktop_config.json:
{
"mcpServers": {
"zenlink": {
"command": "zenlink-mcp"
}
}
}更新日志
1.1.0
- 添加
zen_wait_for_elementtool——轮询DOM，直到选择器出现，而不是固定的睡眠定时器 - 添加
waitForElement作为批处理操作 - 桥梁：新建
/api/wait-for-element具有自动延长超时的端点 - 内容脚本升级到v6
1.0.3
- 首次公开发布