Chrome Live Screenshot MCP

Chrome Live屏幕截图MCP

此项目可从打开的 Chrome 选项卡中获取屏幕保护程序，并将其用作 MCP 工具。

它做什么？

• chrome_list_tabs开放标签列表
• chrome_open_url在开放的Chrome会话中查找/聚焦URL（不会启动新的Chrome进程）
• chrome_screenshot: 获取屏幕保护程序

- 瓦尔萨伊兰： artifact 模式 （写入文件， 路径设置） - 可选： image modu（base64图像生成器）

• chrome_artifact_cleanup清除旧的屏幕截图文件
• 该插件可以同时连接到多个 MCP 端点，并在无全局 FIFO 的情况下请求命令

安装方便

1） Bagimliliklari kur

npm i

2） 铬eklentisni yukle

1. chrome://extensions 交流电
2. Developer mode 交流电
3. Load unpacked 秒
4. 这个仓库 chrome-extension/ 班级秒
5. 插件 Options 屏幕 ：

- Windows原生MCP icin： ws://localhost:8766 - 要从Windows Chrome连接到WSL中的calisan MCP： ws://wsl.localhost:8766

Windows+WSL端点不可用

• 如果服务器在 WSL 中，则默认 bind 主机已经存在 0.0.0.0 它会被切断。
• 如果您想手动设置：

set MCP_CHROME_WS_HOST=0.0.0.0
set MCP_CHROME_WS_ENDPOINT_HOSTS=wsl.localhost,localhost,127.0.0.1

• chrome-extension/options 塔拉芬达露骨 WS URL 威尔迪森（奥尔金 ws://localhost:8766这个值被用作扫描的 seed/priority 提示。
• 再次扫描插件的本地主机/端口池 （localhost, 127.0.0.1, wsl.localhost + 8766-8775可以同时连接到多个 MCP 端点。
• 通过这种方式，即使与MCP复制器备份不同的端口之夜，插件也可以捕捉到其他链接而不会中断。

3） Codex'e MCP ekle

codex mcp add chrome-live-screenshot -- \
  node /node_modules/tsx/dist/cli.mjs \
  /src/index.ts

4） OpenCode'a MCP ekle

~/.config/opencode/opencode.json 添加以下条目：

"chrome-live-screenshot": {
  "type": "local",
  "command": [
    "node",
    "/node_modules/tsx/dist/cli.mjs",
    "/src/index.ts"
  ],
  "enabled": true
}

5） Claude Code'a MCP ekle

项目现场 .mcp.json 将下面的服务器日志添加到文件中：

{
  "mcpServers": {
    "chrome-live-screenshot": {
      "type": "stdio",
      "command": "node",
      "args": [
        "/node_modules/tsx/dist/cli.mjs",
        "/src/index.ts"
      ]
    }
  }
}

然后重新启动 Claude Code 会话以刷新 ac 或 MCP 列表。

公共回购协议：

• Makineye ozel .mcp.json 不要将文件放入仓库。
• 相反，在仓库 .mcp.example.json 将文件复制到本地 .mcp.json 它变成了。

使用

列出标签

chrome_list_tabs 卡吉尔。

URL ac / 来源

chrome_open_url 卡吉尔。

• 只能使用当前打开的 Chrome 会话
• 无法启动新的 Chrome 进程/会话
• 默认行为：默认情况下重复使用标签，否则在现有 Chrome 窗口中弹出新标签
• 输入无效的 URL 时会发生错误（ 默认情况下）
• url 如果没有给出参数，则默认 http://localhost:5173/ 使用

屏幕截图al（onerilen）

chrome_screenshot 放弃。默认情况下，将写入文件并返回数据：

• artifactPath
• mimeType
• byteSize
• width / height

所有决议均已通过

仅仅写入 Path 是不够的。附加文件：

• 食品法典： --image
• OpenCode： --file

有用的论点

chrome_open_url:

• url
• match: prefix | exact
• reuseIfExists （瓦尔萨伊兰 true)
• openIfMissing （瓦尔萨伊兰 true)
• focusWindow （瓦尔萨伊兰 true)
• activateTab （瓦尔萨伊兰 true)
• waitForComplete （瓦尔萨伊兰 true)
• timeoutMs

chrome_screenshot:

• url
• match: prefix | exact
• format: png | jpeg
• jpegQuality: 0-100
• returnMode: artifact （瓦尔萨伊兰）| image
• artifactDir：自定义密码

chrome_artifact_cleanup:

• maxAgeHours （瓦尔萨伊兰24）
• artifactDir （可选）

常见问题

“扩展未连接”

• 检查我的插件
• Windows本机icin WS URL ws://localhost:8766 我 控制
• WSL senaryosuda WS URL ws://wsl.localhost:8766 试试看
• 重新启动 MCP 源码

“MCP启动超时”

~/.codex/config.toml:

[mcp_servers.chrome-live-screenshot]
startup_timeout_sec = 45.0

“您为另一个平台安装了esbuild”

• 此错误通常在Windows和WSL中模拟相同的项目文件夹时发生。
• 文章 npm run dev, npm test, npm run build 尝试自动控制/重建。
• 如果仍然继续，则在活动环境中执行 water 命令一次：

npm rebuild esbuild

“需要‘\’或‘activeTab’权限”

重新装入插件（chrome://extensions检查最后一个 manifest 权限。