Opencode Chrome Dev Tools MCP Setup

OpenCode+Chrome DevTools MCP（WSL->Windows Chrome）

此回购记录了 可靠的 工作流程控制 Windows Chrome浏览器 从 Windows 子系统 for Linux 使用Chrome DevTools协议（CDP）。它包括：

• Chrome_workflow_Setup.txt：PowerShell+WSL启动步骤
• skills/chrome-wsl-bridge/SKILL.md：为代理人提供简化的技能指导

为什么存在

如果您使用实时Chrome配置文件或PowerShell引用出错，则从WSL到Windows Chrome的自动化很脆弱。我们遭遇了多次失败：

• 无法访问CDP终结点，因为Chrome无法访问 不 使用调试标志启动
• 使用Chrome主配置文件（配置文件3）时配置文件锁定
• 以管理员身份运行PowerShell时“创建数据目录失败”
• 从bash调用时引用和环境变量扩展中断

修复方法是：

• 使用一个 专用CDP配置文件文件夹 （持续）
• 启动Chrome 命令提示符 从WSL避免PowerShell引用问题
• 保持CDP打开 端口9333 只有在实际发生故障时才能切换

快速入门（PowerShell）

磨合 Windows PowerShell（非管理员）:

1) taskkill /F /IM chrome.exe

2) $cdpDir = "$env:LOCALAPPDATA\ChromeCDPProfile"
   if (-not (Test-Path $cdpDir)) { New-Item -ItemType Directory -Force -Path $cdpDir | Out-Null }
   icacls "$cdpDir" /inheritance:e /grant "$($env:USERNAME):(OI)(CI)F" | Out-Null

3) Start-Process -FilePath "C:\Program Files\Google\Chrome\Application\chrome.exe" -ArgumentList "--remote-debugging-port=9333","--remote-debugging-address=127.0.0.1","--user-data-dir=$cdpDir","--profile-directory=Default","--no-first-run","--no-default-browser-check","about:blank"

4) curl.exe http://127.0.0.1:9333/json/version

如果步骤4返回JSON，则CDP处于活动状态。

WSL启动（代理安全）

从WSL出发：

cmd.exe /c taskkill /F /IM chrome.exe
cmd.exe /c start "" "C:\Program Files\Google\Chrome\Application\chrome.exe" --remote-debugging-port=9333 --remote-debugging-address=127.0.0.1 --user-data-dir="%LOCALAPPDATA%\ChromeCDPProfile" --profile-directory=Default --no-first-run --no-default-browser-check about:blank
curl -s --connect-timeout 5 http://127.0.0.1:9333/json/version

OpenCode MCP配置

在 ~/.config/opencode/opencode.json 将Chrome DevTools MCP设置为 端口9333:

"chrome-devtools": {
  "type": "local",
  "enabled": true,
  "timeout": 150000,
  "command": [
    "node",
    "/home/vic/.local/share/chrome-devtools-mcp/node_modules/chrome-devtools-mcp/build/src/index.js",
    "--browserUrl",
    "http://127.0.0.1:9333",
    "--viewport=1280x720"
  ]
}

此代码库中包含示例配置代码段（已编辑）：

• opencode.json.sample

端口回退规则

• 留在9333 默认情况下。
• 仅切换到 9334 如果9333在重试后未能返回JSON。

常见问题和修复

• 创建数据目录失败

- 使用 非管理员PowerShell 以及专用CDP配置文件。

• 无法访问CDP

- 确认Chrome已启动 --remote-debugging-port=9333.

• 个人资料未保持登录状态

- 不要在运行之间删除CDP配置文件文件夹。

此存储库中的文件

• Chrome_workflow_Setup.txt
• skills/chrome-wsl-bridge/SKILL.md

安全说明

不要从提交API密钥或令牌 opencode.json在共享配置之前，请先修改机密。