新闻详情

新闻详情

首页 / 资讯中心 / 详情

跟 Claude Code 的 playwright mcp 搏斗记录:从 npm 报错到 Chromium 跑通

发布时间:2026/11/18 19:53:24来源:尧图网络
跟 Claude Code 的 playwright mcp 搏斗记录:从 npm 报错到 Chromium 跑通
1. 从一次截图请求说起Claude Code 里 playwright mcp 为什么跑不起来如果你正在用 Claude Code 做浏览器自动化大概率会遇到这个场景/mcp面板里 playwright 明明显示 connected你让 Claude 截个图它却甩回来一句browserType.launchPersistentContext: Chromium distribution chrome is not found at C:\Users\[user]\AppData\Local\Google\Chrome\Application\chrome.exe。这个报错的核心不是 mcp 没连上而是 playwright 在启动浏览器时找不到它期望的 Chromium 可执行文件。我这次的目标很明确让 Claude Code 通过 playwright mcp 完成「打开 example.com 并截图」这条最小链路。适合谁看正在配 Claude Code playwright mcp 的开发者、被 npm 安装和 Chromium 路径问题卡住的人、以及想搞清楚 mcp 配置里哪些参数真正生效的人。整条链路涉及三个独立环节npm 包安装、playwright 浏览器二进制下载、mcp server 启动时对浏览器路径的解析。任何一环错位都会表现为「connected 但一调用就报错」。下面按我实际排查的顺序展开每一步都给可复制的命令和配置你可以直接对照自己的环境复现。2. 前置准备TaoToken 接入与 Claude Code 环境确认在折腾 playwright mcp 之前先把模型调用这条链路理顺。Claude Code 需要一个可用的 API 端点我用的是 TaoToken 的接入方式官网在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 。它的作用是给 Claude Code 提供兼容的模型对话接口让你在本地终端里正常驱动 Claude 完成编码和工具调用。先确认 Claude Code 本身能跑通。安装和登录按官方文档走登录后在终端执行一次简单对话确认模型能正常返回。这一步不通后面 mcp 的问题会被掩盖。接着确认 Node 和 npm 版本。playwright 对 Node 版本有要求太老的版本会在安装阶段就报错node -v npm -v我实测 Node 18 以上比较稳。如果 npm 版本偏低先升级npm install -g npmlatest然后确认 Claude Code 的 mcp 配置文件位置。不同系统路径不同常见的是用户目录下的.claude.json或项目级的.mcp.json。你可以先用/mcp命令在 Claude Code 里查看当前已加载的 server 列表确认 playwright 是否已经在列。3. 可复制配置playwright mcp 的安装与 mcpServers 写法这一步是重点也是我踩坑最多的地方。先装 playwright 本体和 mcp server 包npm install -g playwrightlatest npm install -g executeautomation/playwright-mcp-server装完后手动下载浏览器二进制。这一步很关键很多人只装了 npm 包没下浏览器npx playwright install chromium如果你希望浏览器装到自定义目录比如 C 盘空间紧张可以指定路径set PLAYWRIGHT_BROWSERS_PATHE:\Program\pw-browsers npx playwright install chromium注意这个环境变量在 mcp server 启动时也要能读到否则它还是会去默认目录找。接下来是 Claude Code 的 mcp 配置。我最终能跑通的写法是这样{ mcpServers: { playwright: { type: stdio, command: cmd, args: [ /c, npx, executeautomation/playwright-mcp-server ], env: { PLAYWRIGHT_BROWSERS_PATH: E:\\Program\\pw-browsers } } } }几个参数说明type用 stdio因为这是本地进程通信command在 Windows 下用cmd配合/c才能正确执行 npxenv里的PLAYWRIGHT_BROWSERS_PATH必须和你安装浏览器时用的路径一致。如果你在 macOS 或 Linuxcommand直接写npx去掉cmd和/c即可。注意配置里的路径用双反斜杠转义JSON 不认单反斜杠。写错会导致 server 启动失败但/mcp可能仍显示 connected容易误导。改完配置后重启 Claude Code再用/mcp确认 playwright 状态。4. 验证请求让 Claude Code 真正打开页面并截图配置就绪后在 Claude Code 里发一条明确的指令Use Playwright to take a screenshot of example.com如果一切正常你会看到它调用playwright - Navigate to a URL工具返回截图或页面标题。但如果你遇到的是我开头那个报错说明 playwright 在找系统 Chrome 而不是它自己下载的 Chromium。报错信息里那句Chromium distribution chrome is not found是关键——它期望的路径是C:\Users\[user]\AppData\Local\Google\Chrome\Application\chrome.exe。我试过几种方案都没用升级 playwright 到 1.5.2、设置PLAYWRIGHT_BROWSERS_PATH0、卸载后从插件市场重装、换 iflow 调用同样的 mcp报错一模一样。说明问题不在 mcp server 本身而在浏览器路径解析。最终解决方案是建一个符号链接把系统期望的 Chrome 路径指向 playwright 实际下载的 Chromium 目录。以管理员权限打开 PowerShellNew-Item -ItemType SymbolicLink -Path C:\Users\[user]\AppData\Local\Google\Chrome\Application -Target E:\Program\pw-browsers\chromium-1134\chrome-win把[user]换成你的用户名chromium-1134换成你实际下载的版本号去pw-browsers目录下看。建完后重新发起截图请求链路就通了。验证成功的标志Claude Code 返回截图文件路径或页面内容不再报 Chromium not found。你也可以单独跑一条命令确认浏览器能启动npx playwright open example.com能弹出浏览器窗口说明二进制没问题剩下的就是 mcp 配置和路径对齐。5. 本篇常见错排查npm、Chromium 与 mcp 配置的坑报错一Chromium distribution chrome is not found这是最高频的。根因是 playwright mcp server 默认去找系统 Chrome而不是它自己下载的 Chromium。解决方式就是上面的符号链接或者把PLAYWRIGHT_BROWSERS_PATH指向正确目录并确保 mcp 的 env 里也带上。报错二npm 安装 playwright 后npx playwright找不到命令多半是全局安装路径没进 PATH。用npm config get prefix看全局目录把它加到系统 PATH 里。或者干脆用npx playwright让它临时解析。报错三/mcp显示 connected 但调用就超时检查 mcp 配置里的command和args。Windows 下如果只写npx不写cmd /c进程可能起不来但状态显示异常。另外确认env里的路径没有拼错。报错四浏览器下载卡住或失败npx playwright install chromium走的是官方下载源网络不稳时会断。可以重试或者先设PLAYWRIGHT_BROWSERS_PATH到有空间的盘再装。报错五换了 firefox 参数仍然报 chrome 找不到配置里加--browserfirefox只影响 mcp server 的默认浏览器选择但如果代码里硬编码了 chrome或者符号链接没建照样报错。先解决路径问题再调浏览器类型。排查顺序建议先确认npx playwright open example.com能独立跑通再看 mcp 配置最后查符号链接。这样能把问题范围缩到最小。6. 后续怎么用模型对话、Coding Plan 与接入文档链路跑通后日常使用就顺了。如果你主要是在 Claude Code 里做浏览器自动化验证可以直接用模型对话能力驱动 mcp 工具模型对话入口在 https://taotoken.net/api 配合 Claude Code 的/mcp面板调用即可。如果你打算长期用 Claude Code 做编码和 Agent 任务建议了解一下 Coding Plan地址是 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 适合需要稳定调用和更高额度的场景。API Key 的管理在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 遇到配置问题先翻文档比盲目试参数快得多。最后留一个我实测有效的习惯每次改完 mcp 配置先重启 Claude Code再用/mcp看状态然后发一条最小指令比如截图 example.com验证。不要一上来就跑复杂任务否则报错信息会被淹没。符号链接那一步做完后记得把目标路径记下来换机器或重装浏览器时直接复用。
网站建设高端定制企业官网
RELATED

相关资讯

更多精彩内容,欢迎继续阅读

较早相关资讯

最新相关资讯

【外设】之大彩串口显示屏 2026/11/17 7:04:08

【外设】之大彩串口显示屏

大彩串口屏初步使用 1 .官网下载 STM32 屏幕 GUI 设计资料 http://www.gz-dc.com/category/typeid/4112 找到 STM32 Keil 工程,移植相关代码因项目而异进行移植,由于项目简单,本人只对用到的指令接口进行修改。 比如:注意事项&…

阅读更多 →
无法下载Windows系统iso文件 2026/11/18 14:20:46

无法下载Windows系统iso文件

当我遇到这个问题的时候,我打开了一个网站: 登录 然后我打算下载的时候: 突然那个官方的连接就可以下载了:

阅读更多 →
【清华代码熊】DeepSeek V4.1 Flash 后训练详解 2026/11/17 19:43:34

【清华代码熊】DeepSeek V4.1 Flash 后训练详解

📌 上期解析了 DeepSeek V4.1 Flash 模型架构改进,本期解析 DeepSeek V4.1 Flash 预训练/后训练技术: 🌟 预训练:45T 文本 多模态混合语料、直接训练 sparse attention(取消 DeepSeek V4 的 dense 冷启动&…

阅读更多 →
Shuffle-R1: Efficient RL framework for Multimodal Large Language Models via Data-centric Dynamic ... 2026/11/18 11:04:06

Shuffle-R1: Efficient RL framework for Multimodal Large Language Models via Data-centric Dynamic ...

文章主要内容和创新点 主要内容 本文聚焦于多模态大语言模型(MLLM)强化学习(RL)训练中的效率问题,提出了一个名为Shuffle-R1的框架。研究发现,当前RL训练存在两个关键缺陷: 优势值坍缩(Advantage Collapsing):批次中大多数优势值集中在零附近,导致有效梯度信号被淹…

阅读更多 →
PRvL: Quantifying the Capabilities and Risks of Large Language Models for PII Redaction 2026/11/18 15:55:22

PRvL: Quantifying the Capabilities and Risks of Large Language Models for PII Redaction

一、文章主要内容总结 本文聚焦于利用大型语言模型(LLMs)实现个人身份信息(PII)脱敏的研究,旨在解决传统脱敏方法(如基于规则的系统、领域特定命名实体识别(NER)模型)泛化能力差、跨格式/跨语境适应性弱的问题。 研究通过全面评估多种LLM架构(包括密集型LLM(D-LLM…

阅读更多 →
LLaVA-RE: Binary Image-Text Relevancy Evaluation with Multimodal Large Language Model 2026/11/17 19:43:32

LLaVA-RE: Binary Image-Text Relevancy Evaluation with Multimodal Large Language Model

文章主要内容和创新点 主要内容 本文聚焦于二进制图像-文本相关性评估任务(判断图像与文本“相关”或“不相关”),针对该任务中文本格式多样、相关性定义随场景变化等挑战,提出了基于多模态大语言模型(MLLM)的解决方案LLaVA-RE。 模型设计:LLaVA-RE基于LLaVA 1.5架构,…

阅读更多 →

今日资讯

本周资讯

本月资讯

看完文章仍有疑问?

联系尧图顾问,获取一对一建站咨询

立即免费咨询 📞 400-888-8888
📞 ✉