ZennoBrowser MCP Server

ZennoBrowser MCP 服务 — 面向 AI Agent 的反检测浏览器自动化

面向 ZennoBrowser 公共 API 的 MCP（模型上下文协议）服务。它向 Claude Desktop、Cursor 和 VS Code 等 MCP 客户端中的 AI Agent 提供浏览器自动化和配置文件管理功能。

为什么选择 ZennoBrowser MCP 服务

• 全面覆盖公共 API。 提供 57 个工具，涵盖工作区、配置文件、文件夹、代理、线程、浏览器实例、预设、扩展和产品信息。
• 专为规模化设计。 批量工具可通过一次调用创建、更新、启动和停止多个配置文件、代理、线程和浏览器实例。
• Cookie 和指纹。 在配置文件之间导入、导出和复制 Cookie，并读取任意配置文件的完整指纹详情。
• 适配你的 AI 客户端。 可作为本地 stdio 服务在 Claude Desktop、Cursor 和 VS Code 中运行。
• 免费开始使用。 ZennoBrowser 适用于 Windows。其 START 套餐包含无限量本地配置文件和 2 个同时运行的浏览器。

快速开始

1. 在电脑上启动 ZennoBrowser，并在 ZennoLab 个人账户中获取 API 令牌。
2. 使用安装中的任一配置，将服务添加到 MCP 客户端。
3. 向 Agent 提出请求，例如：“创建一个名为 "Test Profile" 的新配置文件，然后为其启动一个浏览器实例。”

delete_profile、bulk_delete_profile 和 delete_proxy 等工具的操作无法撤销。批准破坏性调用前，请检查 Agent 的操作。

要求

• Node.js 20+
• 本地运行的 ZennoBrowser
• 有效的 ZennoBrowser API 令牌

安装

此软件包以 @zennolab/zennobrowser-mcp-server 发布。最高至 1.0.0 的版本使用未限定范围的软件包名 zennobrowser-mcp-server 发布，且不再接收更新——请在 MCP 客户端配置中将其替换为 @zennolab/zennobrowser-mcp-server。

npx（无需安装）

Claude Desktop — 编辑 claude_desktop_config.json：

{
  "mcpServers": {
    "zennobrowser": {
      "command": "npx",
      "args": ["-y", "@zennolab/zennobrowser-mcp-server@latest"],
      "env": {
        "ZB_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

Cursor — 添加到 MCP 设置（.cursor/mcp.json 或“设置” → MCP）：

{
  "mcpServers": {
    "zennobrowser": {
      "command": "npx",
      "args": ["-y", "@zennolab/zennobrowser-mcp-server@latest"],
      "env": {
        "ZB_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

VS Code（支持 GitHub Copilot MCP）— 添加到 .vscode/mcp.json：

{
  "servers": {
    "zennobrowser": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@zennolab/zennobrowser-mcp-server@latest"],
      "env": {
        "ZB_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

全局安装

npm install -g @zennolab/zennobrowser-mcp-server@latest

然后使用 zennobrowser-mcp-server 作为命令，替代 npx ... @zennolab/zennobrowser-mcp-server：

{
  "mcpServers": {
    "zennobrowser": {
      "command": "zennobrowser-mcp-server",
      "env": {
        "ZB_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

环境变量

变量	必填	默认值	描述
ZB_API_TOKEN	是	—	ZennoBrowser 公共 API 的身份验证令牌
ZB_API_BASE_URL	否	http://localhost:8160	ZennoBrowser 公共 API 的基础 URL

工具

工作区

工具	描述
get_workspaces	列出可访问的工作区

配置文件

工具	描述
get_profiles	列出配置文件，支持筛选和排序
get_profile	获取单个配置文件及其完整指纹详情
create_profile	创建新配置文件
bulk_create_profile	一次创建多个配置文件
update_profile	更新配置文件设置
delete_profile	删除配置文件
bulk_delete_profile	删除多个配置文件
move_profile	将配置文件移至文件夹
recover_profile	从无效状态恢复配置文件
force_unlock_profile	强制解锁云端锁定的配置文件
import_cookies	导入 Cookie（JSON 或 Netscape 格式）
export_cookies	将 Cookie 导出为 JSON
copy_cookies	将 Cookie 从一个配置文件复制到另一个配置文件
bulk_update_profile_preset	为多个配置文件分配预设
bulk_update_profile_proxy	更新多个配置文件的代理
bulk_update_profile_tags	更新多个配置文件的标签
cleanup_profile	清除配置文件缓存

配置文件夹

工具	描述
get_profile_folders	列出配置文件夹
create_profile_folder	创建配置文件夹
update_profile_folder	重命名配置文件夹
delete_profile_folder	删除配置文件夹

代理

工具	描述
get_proxies	列出代理
create_proxy	创建代理
bulk_create_proxy	创建多个代理
update_proxy	更新代理
delete_proxy	删除代理
bulk_delete_proxy	删除多个代理
change_mobile_proxy_ip	触发移动代理的 IP 轮换

代理文件夹

工具	描述
get_proxy_folders	列出代理文件夹
create_proxy_folder	创建代理文件夹
update_proxy_folder	重命名代理文件夹
delete_proxy_folder	删除代理文件夹

线程

工具	描述
get_threads	列出线程
create_thread	创建线程
bulk_create_thread	创建多个线程
continue_use_thread	延长线程有效期
bulk_continue_use_thread	延长多个线程的有效期
stop_thread	停止线程
bulk_stop_thread	停止多个线程

浏览器实例

工具	描述
get_browser_instances	列出活动的浏览器实例
start_browser_instance	为配置文件启动浏览器实例
bulk_start_browser_instance	为多个配置文件启动浏览器实例
stop_browser_instance	停止浏览器实例
bulk_stop_browser_instance	停止多个浏览器实例
set_browser_instance_visibility	显示或隐藏浏览器窗口

预设和扩展程序

工具	描述
get_presets	列出预设
create_preset	创建预设
delete_preset	删除预设
get_extensions	列出扩展程序
create_extension_from_web	从 Chrome 网上应用店添加扩展程序
create_extension_from_file	从本地 .crx 或 .zip 文件添加扩展程序
delete_extension	移除扩展程序

产品

工具	描述
get_product_version	获取 ZennoBrowser 版本
get_browser_version	获取浏览器引擎版本
get_limits	获取工作区资源限制
get_tariff	获取当前资费信息

示例提示词

创建配置文件并启动浏览器：

创建一个名为 "Test Profile" 的新配置文件，然后为其启动一个浏览器实例。

完整端到端流程：

创建一个名为 "Scraper" 的配置文件，创建一个 URI 为 "socks5://user:[email protected]:1080" 的代理，将代理分配给该配置文件，创建一个线程，然后使用该线程为此配置文件启动一个浏览器实例。

批量操作：

列出默认工作区中的所有配置文件，并删除过去 30 天内未使用过的配置文件。

Cookie 管理：

从配置文件 "Session A" 导出 Cookie，并将其导入配置文件 "Session B"。

故障排除

Error: Missing required environment variable ZB_API_TOKEN 将 ZB_API_TOKEN 环境变量设置为你的 ZennoBrowser API 令牌。

Error: connect ECONNREFUSED 127.0.0.1:8160 ZennoBrowser 未运行，或 Public API 无法正常工作。如果 API 在其他端口上运行，请设置 ZB_API_BASE_URL=http://localhost:<port>。

工具调用返回 "Unauthenticated" 错误 你的 API 令牌无效或已过期。请在 ZennoLab 个人账户中生成新令牌。

npx 每次都会下载软件包 使用 npm install -g @zennolab/zennobrowser-mcp-server@latest 全局安装，避免每次启动时重新下载。

相关内容

• ZennoBrowser — 此服务控制的反检测浏览器
• ZennoLab 文档 — 产品指南（俄语）
• ZennoBrowser 社区论坛 — 提问、报告错误和提交功能请求
• zennoposter-mcp — 用于 ZennoPoster 和 ZennoDroid 的 MCP 服务

许可证

MIT