From 957076c5bd3e996602f1c4355bf5a3352aa5aa00 Mon Sep 17 00:00:00 2001
From: James Feng <47167674+GhostDragon124@users.noreply.github.com>
Date: Thu, 4 Jun 2026 17:27:58 +0800
Subject: [PATCH] =?UTF-8?q?feat:=20=E6=81=A2=E5=A4=8D=20Chrome=20MCP=20?=
 =?UTF-8?q?=E6=B5=8F=E8=A7=88=E5=99=A8=E8=87=AA=E5=8A=A8=E5=8C=96=E6=94=AF?=
 =?UTF-8?q?=E6=8C=81?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 添加 scripts/setup-chrome-mcp.mjs（从上游恢复）
- 添加 docs/features/chrome-use-mcp.md 使用文档
- 恢复 postinstall 中的 Chrome MCP 设置步骤
- CI 中加 CLAUDE_CODE_SKIP_CHROME_MCP_SETUP=1 避免无 Chrome 环境失败
---
 .github/workflows/ci.yml        |  2 +
 .github/workflows/codeql.yml    |  2 +
 docs/features/chrome-use-mcp.md | 38 ++++++++++++++++++
 package.json                    |  2 +-
 scripts/setup-chrome-mcp.mjs    | 70 +++++++++++++++++++++++++++++++++
 5 files changed, 113 insertions(+), 1 deletion(-)
 create mode 100644 docs/features/chrome-use-mcp.md
 create mode 100644 scripts/setup-chrome-mcp.mjs

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 2c59570ea..3051af711 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -24,6 +24,8 @@ jobs:
         run: sed -i '' 's|registry.npmmirror.com|registry.npmjs.org|g' bun.lock
 
       - name: Install dependencies
+        env:
+          CLAUDE_CODE_SKIP_CHROME_MCP_SETUP: '1'
         run: bun install --frozen-lockfile
 
       - name: Test
diff --git a/.github/workflows/codeql.yml b/.github/workflows/codeql.yml
index 80bb154d6..f0e81cfdb 100644
--- a/.github/workflows/codeql.yml
+++ b/.github/workflows/codeql.yml
@@ -33,6 +33,8 @@ jobs:
           bun-version: latest
 
       - name: Install dependencies
+        env:
+          CLAUDE_CODE_SKIP_CHROME_MCP_SETUP: '1'
         run: bun install
 
       - name: Initialize CodeQL
diff --git a/docs/features/chrome-use-mcp.md b/docs/features/chrome-use-mcp.md
new file mode 100644
index 000000000..3cbe91b5a
--- /dev/null
+++ b/docs/features/chrome-use-mcp.md
@@ -0,0 +1,38 @@
+# Chrome Use — 浏览器自动化快速指南
+
+让 Claude Code 直接控制你的 Chrome 浏览器，用自然语言完成网页操作。
+
+## 快速开始（3 分钟）
+
+### 第一步：安装 Chrome 扩展
+
+1. 下载扩展：https://github.com/hangwin/mcp-chrome/releases
+2. 解压 zip 文件
+3. 打开 Chrome 访问 `chrome://extensions/`
+4. 开启右上角「开发者模式」
+5. 点击「加载已解压的扩展程序」，选择解压后的文件夹
+
+### 第二步：启动 CCP
+
+```bash
+bun run dev
+ccp # 或者 ccp 安装版也行
+```
+
+### 第三步：启用 Chrome MCP
+
+1. 在 REPL 中输入 `/mcp` 打开 MCP 面板
+2. 找到 `mcp-chrome`，按空格键启用
+3. 按 Enter 确认
+
+## 在 Linux 服务器上使用
+
+如果你的服务器没有图形界面，可以通过以下方式使用 Chrome MCP：
+
+1. 在本地有 Chrome 的机器上安装扩展
+2. 通过网络将 Chrome DevTools 端口暴露给服务器
+3. 或者使用 `CLAUDE_CODE_SKIP_CHROME_MCP_SETUP=1` 跳过自动设置（之后手动执行 `node scripts/setup-chrome-mcp.mjs`）
+
+## 相关文档
+
+- GitHub 仓库：https://github.com/hangwin/mcp-chrome
diff --git a/package.json b/package.json
index b68a5f870..61e114612 100644
--- a/package.json
+++ b/package.json
@@ -60,7 +60,7 @@
     "check:bundle": "bun run scripts/check-bundle-integrity.ts",
     "check:unused": "knip-bun",
     "health": "bun run scripts/health-check.ts",
-    "postinstall": "node scripts/postinstall.cjs",
+    "postinstall": "node scripts/run-parallel.mjs scripts/postinstall.cjs scripts/setup-chrome-mcp.mjs",
     "docs:dev": "npx mintlify dev",
     "typecheck": "tsc --noEmit",
     "precheck": "bun run typecheck && bun run check:fix && bun test",
diff --git a/scripts/setup-chrome-mcp.mjs b/scripts/setup-chrome-mcp.mjs
new file mode 100644
index 000000000..022fb9e42
--- /dev/null
+++ b/scripts/setup-chrome-mcp.mjs
@@ -0,0 +1,70 @@
+#!/usr/bin/env node
+
+/**
+ * Unified Chrome MCP setup script.
+ *
+ * Usage:
+ *   node scripts/setup-chrome-mcp.mjs           # Run full setup (fix-permissions → register → doctor)
+ *   node scripts/setup-chrome-mcp.mjs doctor    # Run a single sub-command
+ */
+
+import { execFileSync } from 'node:child_process'
+import { mkdirSync } from 'node:fs'
+import { createRequire } from 'node:module'
+import { homedir } from 'node:os'
+import { join } from 'node:path'
+
+if (process.env.CLAUDE_CODE_SKIP_CHROME_MCP_SETUP === '1') {
+  process.exit(0)
+}
+
+const require = createRequire(import.meta.url)
+const cliPath = require.resolve(
+  '@claude-code-best/mcp-chrome-bridge/dist/cli.js',
+)
+
+const userArgs = process.argv.slice(2)
+
+function getChromeMcpLogDir() {
+  const home = homedir()
+  if (process.platform === 'darwin') {
+    return join(home, 'Library', 'Logs', 'mcp-chrome-bridge')
+  }
+  if (process.platform === 'win32') {
+    return join(
+      process.env.LOCALAPPDATA || join(home, 'AppData', 'Local'),
+      'mcp-chrome-bridge',
+      'logs',
+    )
+  }
+  return join(
+    process.env.XDG_STATE_HOME || join(home, '.local', 'state'),
+    'mcp-chrome-bridge',
+    'logs',
+  )
+}
+
+if (userArgs.length > 0) {
+  // Forward single sub-command
+  execFileSync('node', [cliPath, ...userArgs], { stdio: 'inherit' })
+} else {
+  // Full setup sequence
+  const steps = [
+    ['fix-permissions'],
+    ['register', '--browser', 'chrome'],
+    ['doctor'],
+  ]
+
+  mkdirSync(getChromeMcpLogDir(), { recursive: true })
+
+  for (let i = 0; i < steps.length; i++) {
+    const args = steps[i]
+    const isLast = i === steps.length - 1
+    if (isLast) console.log(`\n[${i + 1}/${steps.length}] ${args.join(' ')}`)
+    execFileSync('node', [cliPath, ...args], {
+      stdio: isLast ? 'inherit' : 'pipe',
+    })
+  }
+
+  console.log('\nChrome MCP setup complete!')
+}