ZenLink MCP

ZenLink MCP

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

v2.0.0 新增约 50 个工具，支持并行 Agent 工作：真正的多标签页并行处理、防止标签页卸载、会话保存与恢复、Readability + Markdown 提取、请求拦截、Cookie/存储，以及编排基础功能（广播、同步屏障、标签页池、命名标签）。完整列表请参阅 CHANGELOG.md。

安装

pip install zenlink-mcp

要求

• 在 Zen Browser 中安装 ZenLink browser extension，版本为 v2.0.0+
• ZenLink 桥接程序正在运行（python native/bridge.py）

工具列表（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 选择器在页面中出现并变为可见。找到目标后会立即返回，而不是固定时长后才返回——等待动态/JS 渲染的内容时，请使用它代替 sleep。

{"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 Desktop 设置

添加到你的 claude_desktop_config.json：

{
  "mcpServers": {
    "zenlink": {
      "command": "zenlink-mcp"
    }
  }
}

更新日志

完整历史记录请参阅 CHANGELOG.md。v2.0.0 的亮点：

• 在内容提取、交互、网络、会话和编排方面新增约 50 个 MCP 工具
• 通过 zen_parallel + zen_keep_alive 实现真正的多标签页并行操作
• 支持保存和恢复会话，适用于一次认证、多次使用的流程
• 使用 zen_intercept 拦截分析和广告（Agent 运行时页面速度提升 3–10 倍）
• 使用 zen_readability + zen_markdown 高效提取页面内容，节省令牌
• 通过 zen_reload_extension 热重载

链接

• ZenLink 桥接程序与扩展
• MCP 注册表

_{mcp-name: io.github.JayQuan-McCleary/zenlink-mcp}