Chrome MCP Server — Extension-Based Browser MCP

简介

Chrome MCP 已核验来源于 hangwin/mcp-chrome（11,586 stars，许可证 MIT）。适合：希望用 MCP 驱动 Chrome，但不想每次都启动独立浏览器进程、可接受安装扩展的用户。兼容：Node.js 20+、Chrome/Chromium；支持 streamable HTTP 或 stdio 的 MCP client（仓库）。装机时间：10 分钟。

量化信息

• 默认 MCP URL： http://127.0.0.1:12306/mcp（仓库）
• 需要 Node.js >= 20（仓库）

深度说明

解决什么问题

把“找到项目 → 安装 → 首次验证 → 回滚/升级”变成可复用流程，避免只靠一次性提示词或截图操作。

最小心智模型

• GitHub 仓库是事实来源：安装、配置、升级、已知问题都以它为准。
• 第一次只做最小闭环：一个命令安装、一个命令验证、一个可回滚方案。
• 记录基线：装机耗时、首次成功输出、完成 1 个真实任务的证据。

安全推广清单

1. 核验来源：确认仓库 URL / stars / license 与预期一致。
2. 按“快速使用”完成安装与首次检查。
3. 跑通“验证命令”，把输出留档。
4. 标注 owner，并写清升级/回滚步骤。

常见排障

• 装了但看不到效果

  • 常见原因：需要重启 CLI/IDE 或配置文件路径不对。
  • 处理：重启后再跑一遍“验证命令”。

• 一台机器能跑，另一台不行

  • 常见原因：Node/Python/Docker 版本差异或缺少系统依赖。
  • 处理：固定版本，并拷贝最小可用配置。

• token 成本/延迟超预期

  • 常见原因：工具 schema 或输出过长被塞进上下文。
  • 处理：拆小步骤、缓存结果、尽量让工具输出更短。

FAQ

Q: 为什么 pnpm 需要额外步骤？ A: README 提到 pnpm 默认可能禁用 postinstall；可开启 enable-pre-post-scripts 或手动执行 register。

Q: 多 agent 同时用安全吗？ A: 建议同一时间只让一个 client 控制浏览器，把浏览器状态当作共享资源，明确“谁是驾驶员”。

Q: 怎么确认连通？ A: 先在扩展 UI 里完成 connect，再让 MCP client 枚举 server 并调用一个最小工具验证。