🎁 福利专区全网大模型免费应用 + 新用户福利 + 注册活动入口,低成本玩转 AI

Chrome 桥接 phoenixlucky/chrome-mcp-bridge-2026-skill

DeepSeek Harness
phoenixlucky47 天前有提交已提供中文文档扫描:含敏感能力

连接本地 Chrome 自动化服务,让 AI 稳定操控浏览器

30.1/100
综合分
1
GitHub 星标
—
npm 周下载
—/5
用户评分

数据截至 2026/9/24 · 周下载取自 npm 全网(含 CI / 镜像),非本站安装数;综合分由星标、活跃度与兼容性检查合成。

该插件未发布到 npm,按作者文档从 GitHub 源安装即可(静态检查只覆盖 npm 路径,不代表插件不可用)。
安装命令 · 需先装 dsh CLI 引擎
dsh plugin --profile web add phoenixlucky/chrome-mcp-bridge-2026-skill
该包不可直接 npm 安装,改从 GitHub 源安装(明细见下方安装检查)

状态速览

判定依据:实装验证 · 静态安装检查 · 自动扫描 · 仓库维护状态
信任档位:已验证
是什么
dsh 原生插件 · browser
装得上吗
本站已在 dsh 0.2.1-rc.5 下真实安装成功
非静态推断
L5 · 运行时冒烟等级说明 →
安全吗
本站尚未对该插件做风险分级
暂未覆盖,不等同于无风险
还在维护吗
更新放缓:最近一次提交在 47 天前
档位由哪些信号合成

本站实装验证(真实安装 L4 覆盖全站;L5 为运行时冒烟或实机截图,覆盖范围小于 L4) · 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。 下方各区块是它的证据明细。

验证判据与等级说明 →
社区实装还没有人打卡 · 装过的第一个就是你
安装兼容性检查需源码安装

仓库 package.json 标记 private,未发布到 npm,需从源码安装

展开查看检查明细 ↓

以下结论由程序自动检查 npm 包、engines 声明与入口文件得出,未做人工实机验证——能装不等于用着没问题。

✗npm 包chrome-mcp-bridge-2026-skill(未发布到 npm,仅可源码安装)
✓Node 引擎要求 >=18 · 基线 Node 22.19 满足
✓dsh CLI 依赖未声明 dsh 版本约束
✓入口文件main/exports/bin 已声明

源码安装时若 pnpm 拦截 prepare 脚本,按其提示在 pnpm-workspace.yaml 的 allowBuilds 中放行后重跑。

验证方式:npm registry 存在性 + package.json 静态校验 · 最后检查 2026/10/7 14:41:14

安全扫描自动 · 静态分析源码
v2.7.0
🔵 扫描:含敏感能力尚无人工评估
展开查看扫描说明与证据 ↓

静态扫描发现插件具备触达本地系统的能力:执行外部命令、读写/删除本地文件、读取剪贴板或密钥类环境变量(至少其一)。这是能力清单,不是危险判定——具体能力项与证据见下方,安装前请自行判断是否需要。

读写/删除本地文件读取剪贴板或密钥环境变量发起外部网络请求
查看扫描证据(共 22 处,展示前 20 条)
  • 读取密钥环境变量
    mcp-bridge.js:45
    const CHROME_MCP_API_KEY = process.env.CHROME_MCP_API_KEY?.trim();
  • 读取本地文件
    mcp-bridge.js:100
    if (fs.statSync(file).size + buf.length > DIAG_MAX_BYTES) return;
  • 写入本地文件
    mcp-bridge.js:101
    fs.appendFileSync(file, buf);
  • 写入本地文件
    mcp-bridge.js:109
    try { fs.writeFileSync(file, ''); } catch { }
  • 读取本地文件
    mcp-bridge.js:122
    if (fs.existsSync(SESSION_FILE)) {
  • 读取本地文件
    mcp-bridge.js:123
    const raw = fs.readFileSync(SESSION_FILE, 'utf-8');
  • 写入本地文件
    mcp-bridge.js:132
    fs.writeFileSync(SESSION_FILE, JSON.stringify({ sessionId, savedAt: Date.now() }), 'utf-8');
  • 读取本地文件
    mcp-bridge.js:140
    if (fs.existsSync(SESSION_FILE)) fs.unlinkSync(SESSION_FILE);
  • 发起网络请求
    mcp-bridge.js:310
    response = await fetch(MCP_URL, {
  • 发起网络请求
    mcp-bridge.js:829
    const response = await fetch(STATUS_URL, { headers, signal: controller.signal });
  • 读取本地文件
    mcp-bridge.js:855
    const raw = fs.readFileSync(filePath, 'utf-8');
  • 读取本地文件
    mcp-bridge.js:868
    if (!fs.existsSync(resolved)) continue;
  • 读取本地文件
    install.js:83
    const template = JSON.parse(fs.readFileSync(TEMPLATE_PATH, 'utf-8'));
  • 读取本地文件
    install.js:94
    if (fs.existsSync(outPath)) {
  • 读取本地文件
    install.js:95
    const existing = fs.readFileSync(outPath, 'utf-8').trim();
  • 写入本地文件
    install.js:111
    fs.mkdirSync(path.dirname(outPath), { recursive: true });
  • 写入本地文件
    install.js:112
    fs.writeFileSync(outPath, `${JSON.stringify(config, null, 2)}\n`, 'utf-8');
  • 发起网络请求
    install.js:128
    const response = await fetch(statusUrl, { headers, signal: controller.signal });
  • 读取本地文件
    install.js:190
    if (!fs.existsSync(BRIDGE_PATH)) {
  • 读取本地文件
    install.js:196
    if (!fs.existsSync(TEMPLATE_PATH)) {
扫描于 2026/11/4(0 天前) · 范围 入口闭包 + 全包扫描 · 来源 GitHub 仓库

静态扫描只反映源码中出现的调用,不构成安全背书;人工评估与自动扫描相互独立、互不覆盖。

给这个插件打分还没有人投票↓
用户评分
还没有人投票,来当第一个

功能亮点

  • 连接本地Chrome服务
  • 稳定操控浏览器

为 AI 代理提供稳定可靠的 Streamable HTTP MCP 连接能力

README

由 DeepSeek 最新模型翻译生成
chrome-mcp-bridge-2026-skill 新版 MCP 2026-07-28 /mcp-new bridge · v4.2.0 连接已有的本地 Chrome 浏览器自动化 MCP 服务。 解决的问题 本项目内置并固定使用仓库根目录的 mcp-bridge.js,避免 skill 文档、全局安装目录和备份目录之间发生版本错位。默认连接: http://127.0.0.1:12306/mcp-new /mcp-new 是 MCP 2026-07-28 的无会话端点:每条请求独立处理,不执行或等待 initialize,不保存或回传 Mcp-Session-Id。旧 /mcp 才使用 Session 兼容流程。 快速开始 前置条件:Node.js ≥ 18,且 Chrome MCP 服务、扩展和 Native Host 已经运行。 1. 生成 MCP 客户端配置(自动填入本仓库 bridge 的绝对路径) node install.js # 跨平台,推荐 .\install.ps1 # PowerShell 等价写法 2. 自检整条链路 node mcp-bridge.js doctor 3. 完全重启 AI 客户端,让它读取生成的 .mcp.json 安装器只生成/合并配置,不会启动或注册后端服务。它会在写入后立刻探测一次后端,提前暴露链路问题。
展开完整文档(README 剩余 1 节)
chrome-mcp-bridge-2026-skill

新版 MCP 2026-07-28 /mcp-new bridge · v4.2.0

连接已有的本地 Chrome 浏览器自动化 MCP 服务。

解决的问题

本项目内置并固定使用仓库根目录的 mcp-bridge.js,避免 skill 文档、全局安装目录和备份目录之间发生版本错位。默认连接:

http://127.0.0.1:12306/mcp-new

/mcp-new 是 MCP 2026-07-28 的无会话端点:每条请求独立处理,不执行或等待 initialize,不保存或回传 Mcp-Session-Id。旧 /mcp 才使用 Session 兼容流程。

快速开始

前置条件:Node.js ≥ 18,且 Chrome MCP 服务、扩展和 Native Host 已经运行。

1. 生成 MCP 客户端配置(自动填入本仓库 bridge 的绝对路径)
node install.js # 跨平台,推荐
.\install.ps1 # PowerShell 等价写法

2. 自检整条链路
node mcp-bridge.js doctor

3. 完全重启 AI 客户端,让它读取生成的 .mcp.json

安装器只生成/合并配置,不会启动或注册后端服务。它会在写入后立刻探测一次后端,提前暴露链路问题。

自检(doctor)

一条命令回答"现在到底能不能用":

node mcp-bridge.js doctor # 人类可读
node mcp-bridge.js doctor --json # 机器可读,便于脚本/代理判断

输出示例:

mcp-bridge.js doctor (v4.2.0)
端点: http://127.0.0.1:12306/mcp-new Origin: http://127.0.0.1

✅ Node.js 运行时 v22.22.2 ✅ bridge 脚本 D:\home\chrome-mcp-bridge-2026-skill\mcp-bridge.js ✅ AI 客户端配置 D:\home\chrome-mcp-bridge-2026-skill\.mcp.json — mcpServers.chrome → 本仓库 bridge ✅ 后端服务 http://127.0.0.1:12306/status?probe=1 — HTTP 200(服务 v2.7.6) ✅ 浏览器链路 connectionState=ready · extension=ready · nativeHost=ready · probe=ok(4ms) ✅ 工具清单 80 个工具

结论: ✅ 一切就绪,可以开始浏览器任务。

退出码 0 表示全部通过,1 表示存在问题;失败项会附带「下一步」提示。

⚠️ 不要再用裸 Invoke-RestMethod 'http://127.0.0.1:12306/status?probe=1' 判断服务状态:/status 同样校验 Origin,缺少合法 Origin 时只会返回 {"error":"MCP requests must include an allowed Origin or a valid API key."},看起来像服务故障。doctor 已经带上了正确 Origin,请优先使用它。

CLI 命令

node mcp-bridge.js --help # 完整帮助
node mcp-bridge.js --version # 版本号
node mcp-bridge.js doctor # 自检
node mcp-bridge.js tools # 列出全部工具(名称 + 用途,一行一个)
node mcp-bridge.js tools # 只看某个工具的完整 inputSchema
node mcp-bridge.js init # 初始化连接(走 server/discover)
node mcp-bridge.js ping # 心跳保活
node mcp-bridge.js path # 显示脚本绝对路径
node mcp-bridge.js close # 清理旧 /mcp Session

调用工具:

--stdin:最省心,避免 shell 转义(推荐) $body = @'
{"name":"chrome_navigate","arguments":{"url":"https://example.com?lang=en"}}
'@
$body | node mcp-bridge.js call tools/call --stdin

或把 JSON 写进文件
node mcp-bridge.js call tools/call --args-file .\params.json

tools 只打印名称和一句用途,比直接 dump 80 个工具的完整 schema 清爽得多;需要精确参数时再 tools 。

MCP 客户端配置

stdio 客户端

{
"mcpServers": {
"chrome": {
"command": "node",
"args": ["__BRIDGE_PATH__", "--server"],
"env": {
"MCP_SERVER_URL": "http://127.0.0.1:12306/mcp-new",
"MCP_PROTOCOL_MODE": "stateless",
"MCP_PROTOCOL_VERSION": "2026-07-28",
"MCP_SERVER_ORIGIN": "http://127.0.0.1",
"CHROME_MCP_API_KEY": ""
}
}
}
}
完整模板见 .mcp.json.example;node install.js 会把 __BRIDGE_PATH__ 替换为真实绝对路径。服务启用鉴权时填写 CHROME_MCP_API_KEY;不要提交真实 key。

--server 与 --stdio 等价,两者都可作为入口。

Streamable HTTP 客户端

只有客户端能为每一条请求生成新版 headers、_meta 和合法 Origin 时,才直接配置:

{
"mcpServers": {
"chrome-mcp-new": {
"type": "streamableHttp",
"url": "http://127.0.0.1:12306/mcp-new"
}
}
}

如果客户端不能自定义 Origin,或仍发送旧式 initialize/Session 请求,请改用上面的 mcp-bridge.js --server。

/mcp-new 新版请求契约

bridge 对每个 HTTP POST 自动发送:

| 位置 | 要求 |
| MCP-Protocol-Version | 必须为 2026-07-28 |
| Mcp-Method | 必须与 JSON-RPC method 完全一致 |
| Mcp-Name | tools/call 必须携带,且与 params.name 完全一致 |
| Origin | 必须是服务端白名单中的合法值;默认 http://127.0.0.1 |
| params._meta | 必须包含协议版本,并携带 clientInfo/clientCapabilities |
| Mcp-Session-Id | /mcp-new 不发送、不保存、不依赖 |

同时使用 Content-Type: application/json 和 Accept: application/json, text/event-stream。_meta 是 JSON-RPC body 中的协议元数据,不是 HTTP header;调用方已有的 _meta 会由 bridge 保留并合并。

不要手写这些请求——用 bridge 即可。

环境变量

| 变量 | 默认值 | 说明 |
| MCP_SERVER_URL | http://127.0.0.1:12306/mcp-new | 后端端点;/mcp 使用旧兼容协议 |
| MCP_PROTOCOL_MODE | auto | auto、stateless 或 legacy |
| MCP_PROTOCOL_VERSION | 按端点选择 | /mcp-new 默认 2026-07-28 |
| MCP_SERVER_ORIGIN | http://127.0.0.1 | 发给 HTTP 服务的 Origin;必须在白名单中 |
| CHROME_MCP_API_KEY | 空 | 发送为 Authorization: Bearer |
| MCP_BRIDGE_DIAG | 关闭 | 设为 1 把 stdio 收发写入临时目录诊断日志 |
| DEBUG | 关闭 | 设为 1 输出详细调试日志 |

注意:MCP_SERVER_ORIGIN 对 HTTP 请求同样生效,不是只给 stdio 配置使用。不要使用服务端未白名单允许的伪造 Origin。

排障

| 现象 | 原因与处理 |
| doctor 报「未找到 .mcp.json」 | 运行 node install.js,然后完全重启 AI 客户端 |
| 客户端里看不到 chrome 工具 | 配置路径不对,或客户端未完全重启;node mcp-bridge.js doctor 会指出配置位置 |
| 无法连接 / ECONNREFUSED | 本地 Chrome MCP 服务未运行;启动服务,或检查 CHROME_MCP_AUTOSTART_SERVER 是否被设为 0 |
| HTTP 401 / 403 | 检查 CHROME_MCP_API_KEY 与 MCP_SERVER_ORIGIN 是否在服务端白名单中 |
| 链路不 ready | Chrome 未打开、扩展未启用,或 Native Host 未注册 |
| 工具数为 0 | 检查扩展连接与 CHROME_MCP_ALLOWED_TOOLS 白名单 |
| 远程/云端 AI 中连不上 | 云端环境里的 127.0.0.1 指向云端机器,访问不到你电脑上的 Chrome |

验证与测试

npm test # 或下面的等价写法
node --test "test/*.test.js"
node mcp-bridge.js doctor # 端到端链路自检

项目结构

chrome-mcp-bridge-2026-skill/
├── mcp-bridge.js # 新版 /mcp-new bridge,同时兼容旧 /mcp ├── install.js # 跨平台配置生成器(Windows/macOS/Linux) ├── install.ps1 # install.js 的 PowerShell 包装器 ├── SKILL.md # AI 代理使用规则 ├── references/tool-catalog.md # 80 个工具的用途和选择路径 ├── .mcp.json.example # stdio 配置模板 ├── package.json # npm test / doctor / tools 脚本 └── test/ # 配置、新版协议与 CLI 回归测试详细规则见 SKILL.md,工具用途见 references/tool-catalog.md;上游接口说明见 MCP_NEW_zh.md。
预览分享卡片长什么样 ↓phoenixlucky/chrome-mcp-bridge-2026-skill
分享 · DeepSeek Harness Hub
phoenixlucky/chrome-mcp-bridge-2026-skill

连接本地 Chrome 自动化服务,让 AI 稳定操控浏览器

这是你的仓库?认领条目

回到顶部