<p align="center"><img src="assets/logo.png" width="96" alt="Xiaodao AI-Browser MCP logo"></p> <p align="center"><img src="assets/promo/xiaodao-mcp-banner-1200x630.png" alt="Xiaodao AI-Browser MCP Server — Windows browser automation MCP server with 351 tools, Chromium/CEF kernel, stdio transport" width="100%"></p>

Xiaodao AI-Browser MCP Server（小刀 AI 浏览器 MCP 服务端） is a local browser automation MCP server for Windows built on the Chromium / CEF kernel. It speaks MCP over stdio (no ports, no daemon) and exposes 351 tools covering navigation, extraction, form filling, screenshots/PDF, network capture & HAR export, Chrome DevTools Protocol (CDP) control, JavaScript debugging & reverse engineering (function hooks, hot patching, precise coverage, obfuscation detection), anti-detect fingerprinting, and kernel-level CEF events. 关键词 / Keywords: MCP server, browser automation, Chromium, CEF, CDP, Chrome DevTools Protocol, web scraping, HAR, Playwright alternative, Puppeteer alternative, reverse engineering, JS debugging, anti-detect, fingerprint, headless-less local browser, Windows, Claude Desktop, Cursor, Trae, DeepSeek Harness, 浏览器自动化, 逆向, 指纹, 反检测.

宣传图 / Promo

| 产品全貌 | 六卖点 | |---|---| | | |

| x64 + x86 双架构 | 行业场景 | |---|---| | | |

另有 真 Chromium 内核 与 免费发布 卡片。素材规格见 assets/promo/README.md。 支持/Support: SUPPORT.md · 安全/Security: SECURITY.md · 许可/License: LICENSE · 兼容性: docs/COMPATIBILITY.md · 部署: docs/DEPLOYMENT.md · 架构: docs/ARCHITECTURE.md · SBOM: docs/SBOM.md · 路线图: docs/ROADMAP.md · 签名: docs/CODE-SIGNING.md

Xiaodao AI-Browser MCP Server · 小刀 AI 浏览器 MCP Server

Windows 本地浏览器自动化 MCP 服务端 —— Google Chromium / CEF 内核、仅 stdio 通道（--mcp-stdio）、351 个工具。 A local browser-automation MCP server for Windows (Chromium/CEF, stdio-only, 351 tools).

最新版本 / Latest: v3.3.6 → 见 Releases。本仓发布成品；源码维护在 AI-XiaoDao/xiaodao-ai-browser-mcp-src。

快速下载 / Quick download

| 系统 | 选择 | 包内内容 | |---|---|---| | 64 位 Windows 10/11 | xiaodao-ai-browser-mcp-v3.3.6-x64.zip | 351 工具 + 完整 64 位 CEF 运行库 + Logo + 用户手册 | | 32 位 Windows 10/11 | xiaodao-ai-browser-mcp-v3.3.6-x86.zip | 351 工具 + 完整 32 位 CEF 运行库 + Logo + 用户手册 |

不要混用两个包：CEF、sqlite 与原生 DLL 都有位数要求。

安装（三步） / Install (3 steps)

1. 按系统位数下载并解压对应 zip → Download & unzip the package for your Windows architecture
2. 以 AI-Fbowser-Mcp.exe 所在目录为运行目录 → Use the folder containing AI-Fbowser-Mcp.exe as the working directory
3. AI-Fbowser-Mcp.exe --print-config 输出可直接粘贴进 MCP 客户端配置的 JSON（自动带本机真实路径） → --print-config prints a ready-to-paste mcpServers JSON block with the real local path.

下载行为：默认 auto_download_save=true，浏览器内点击下载会静默保存到运行目录的 Downloads，不会弹“另存为”。页面下载完成时，browser_event 可查 download_start / download_progress / download_complete。

环境变量 / Environment

| 变量 | 作用 | |---|---| | AI_BROWSER_MCP_STDERR_UTF8=1 | 把日志(stderr)编码从默认 936/GBK 切到 UTF-8（true/yes/on 亦可）。默认 GBK 与中文 Windows 控制台一致，完全向后兼容；非中文 Windows 或期望 UTF-8 日志时置此变量。 | | AI_BROWSER_MCP_TOOLS_DIR | 工具目录（一般无需手工设置） |

实测：同一构建，UTF-8 模式下按 UTF-8 解码替换符 0 个；不置变量时按 GBK 解码替换符 6 个。 另查实：默认模式 stderr 为混合编码（项目日志 GBK + CEF 子进程 UTF-8）⇒ 置变量后整条流统一 UTF-8。

资产 / Release assets

| 文件 | 说明 | |---|---| | xiaodao-ai-browser-mcp-v3.3.6-x64.zip | 64 位成品（351 工具，完整 CEF 运行库 + Logo + 用户手册；170,217,800 B；内层 exe MD5 5D1BF75EC36B19E0127AA7DF181358FE，9,860,096 B） | | xiaodao-ai-browser-mcp-v3.3.6-x86.zip | 32 位成品（351 工具，完整 32 位 CEF 运行库 + Logo + 用户手册；147,353,542 B；内层 exe MD5 90D03B329DF924EA49903E2FA52685DA，8,166,912 B） | | 00-checksums-sha256-md5.csv | 全部发布资产的 MD5 + SHA256 |

验收（机对机） / Verification

v3.3.6 最终构建：x64 / x86 均为 0 错误、0 警告。

• 协议级客户端矩阵基线 7/7、transport 3/3（2026-09-19 实测；套件随仓发布，可复跑），当前构建 tools/list 实测 351 个工具。
• 欢迎页已重构为“快速接入 / 核心能力 / 兼容性 / 关于”结构；接入说明覆盖 Cursor、Claude Desktop、Codex、Cline、Windsurf、Trae、Cherry Studio、Roo Code、DeepSeek Harness、WorkBuddy 等。真实 GUI 客户端需按各自环境用 --print-config 实测。
• CDP 健康状态机已按 AI 调用节奏修复：重命令按方法给探测预算，失败冷却 30 秒，截图不再被 1.2 秒探测误杀；v3.3.6 变更见 CHANGELOG-v3.3.6.md；v3.3.4 审计档案见 docs/AUDIT-3.3.4.md。

已知边界 / Known limits

完整 v3.3.4 审计档案（历史）：docs/AUDIT-3.3.4.md

• exe 未做代码签名（SmartScreen 会提示）· no code signing yet
• 缓存库"内容型"毒化触发条件不可构造，仅有启发式安全网 · cache-DB content-poisoning has no reproducible trigger (heuristic net only)
• 非 tools/call 的 initialize/workflow_stop 在全忙期仍入队（有界延迟，不丢请求）· those still queue while the worker pool is saturated (bounded, never dropped)
• x86 构建暂不启用进程/CacheData 内联统计（会破坏回调 ABI），browser_resources 明确返回 metrics_available:false。
• 虚拟 UA、预注入插装等会重启渲染器或阻塞调试通道的操作默认需要显式确认；这是内核能力边界，不是静默成功。

仓库结构 / Repository layout

README.md                  本文件（中英双语）
dist/x64/AI-Fbowser-Mcp.exe  v3.3.6 64 位 exe 本体
dist/x86/AI-Fbowser-Mcp.exe  v3.3.6 32 位 exe 本体
docs/QUICKSTART_ZH.md     快速上手（中文）
docs/QUICKSTART_EN.md     Quick Start (English)
docs/CHANGELOG.md         更新日志
docs/VERIFICATION.md      验收事实（机对机证据）
docs/KNOWN-LIMITS.md      已知边界
examples/mcp_config.example.json  客户端配置示例（含 UTF-8 开关）
assets/                    图标与宣传图（assets/promo）

exe 本体在 dist/x64 / dist/x86；完整运行库压缩包不进入 Git 历史，随 Releases 分发。 发布仓只包含成品、文档、测试与宣传资源；源码不会进入发布仓。

能力与优势 / Capabilities & Advantages

• 能力清单（按域归类，351 工具）：docs/CAPABILITIES.md
• 优势与差异化（每条均可核验）：docs/ADVANTAGES.md