浏览器自动化服务

ZenLink MCP是一个通过ZenLink实现浏览器自动化的服务器,为Claude Desktop等MCP客户端提供原生浏览器控制功能。

  • by JayQuan-McCleary
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 JayQuan-McCleary/ZenLink-MCP

使用说明

ZenLink MCP

通过ZenLink实现浏览器自动化的MCP服务器——通过Zen浏览器(基于Firefox)为Claude Desktop和其他MCP客户端提供原生浏览器控制。

v2.0.0版本 发布了约50种用于并行代理工作的新工具:真正的多标签并行、标签卸载器防御、会话保存/恢复、可读性+Markdown提取、请求拦截、Cookie/存储和编排原语(广播、同步屏障、标签池、命名标签)。看 更改日志.md 查看完整列表。

安装

pip install zenlink-mcp

需求

刀具表面(75+刀具)

下面的每个标签感知工具都接受一个可选 tab_id 参数——将其传递给驱动特定选项卡而不窃取焦点,这是并行多选项卡工作的基础。

核心

zen_status, zen_health, zen_tabs, zen_new_tab, zen_close_tab, zen_switch_tab, zen_navigate, zen_screenshot

内容提取(一次阅读,成本低廉)

zen_page_text, zen_page_info, zen_readability, zen_markdown, zen_query, zen_html, zen_links, zen_images, zen_meta, zen_structured_data, zen_bounds, zen_computed_style, zen_dom, zen_forms, zen_iframes, zen_explain_selector, zen_full_page_metrics

交互

zen_click, zen_trusted_click, zen_double_click, zen_type, zen_fill, zen_form_fill, zen_set_editable_content, zen_select_option, zen_check, zen_focus, zen_blur, zen_keypress, zen_submit_form, zen_drag, zen_hover, zen_scroll, zen_find, zen_highlight, zen_click_and_wait_navigation

视觉的

zen_screenshot, zen_element_screenshot, zen_full_page_screenshot

选项卡和窗口管理

zen_pin_tab, zen_mute_tab, zen_duplicate_tab, zen_reload_tab, zen_back, zen_forward, zen_get_zoom, zen_set_zoom, zen_windows, zen_create_window, zen_close_window, zen_focus_window, zen_move_tab, zen_detach_tab

网络、Cookie、状态

zen_cookies, zen_storage (本地/会话), zen_clipboard, zen_downloads, zen_clear_browsing_data, zen_intercept, zen_capture_network, zen_wait_for_network_idle, zen_wait_for_url, zen_wait_for_title, zen_watch_console, zen_console_logs

会话(认证一次使用多次)

zen_save_session, zen_load_session, zen_list_sessions, zen_delete_session

编排(并行多选项卡)

zen_keep_alive, zen_keep_alive_stop, zen_wake_tab, zen_broadcast, zen_sync_barrier, zen_tag_tab, zen_resolve_tag, zen_list_tags, zen_untag_tab, zen_tab_pool, zen_pool_acquire, zen_pool_release, zen_parallel

批处理/脚本编写

zen_batch (与 parallel, if, while, try, sequence, retry, ${$N.field} 变量替换)

可观察性/政策

zen_logs, zen_audit, zen_set_policy, zen_get_policy, zen_retry, zen_reload_extension

等待图元

zen_wait_for_element, zen_wait_for_result, zen_wait_for_url, zen_wait_for_title, zen_wait_for_network_idle

工作流程

zen_workflows, zen_workflow, zen_cache, zen_wp_html

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, trustedClick,以及 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"
    }
  }
}

更新日志

看 更改日志.md 完整的历史。v2.0.0的亮点:

  • 约50个新的MCP工具,涵盖内容提取、交互、网络、会话和编排
  • 真正的并行多标签工作通过 zen_parallel + zen_keep_alive
  • 会话保存/恢复用于身份验证,一次使用多个流
  • zen_intercept 阻止分析/广告(代理运行时页面加速3-10倍)
  • zen_readability + zen_markdown 用于令牌高效的页面提取
  • 通过热重新加载 zen_reload_extension

链接

mcp名称:io.github。JayQuan McCleary/zenlink mcp