摘要：

诸位道友有礼了！今日贫道不谈结丹元婴，只论那 AI 界的炼器之道。

听闻 ModelScope 宗门（魔搭社区）新出了一门 MCP Playwright 神通，可化身虚空傀儡，神游万维网。贫道近日偶得法宝 CC Switch（一款极佳的 MCP 管理阵枢），遂闭关三日，终于将其炼化融合。特此刻录玉简，传授这“虚空傀儡术”的配置心法。

关键词：MCP Server, Playwright, CC Switch, AI Agent, 自动化测试, 凡人修仙传

🛑 卷首语：何为“虚空傀儡”？

在 AI 修仙界，我们常需让大语言模型（LLM）去读取网页、点击按钮、抓取数据。若每次都由道友亲力亲为，岂不耽误了修炼？

• MCP (Model Context Protocol)：乃是连接“大模型元神”与“外部工具”的通用法阵。

• Playwright：本是凡间测试神器，被封装成 MCP 后，便成了可受 AI 驱使的**“虚空傀儡”**。

• CC Switch：乃是 Farion 大师所炼制的**“万界阵枢”**，可统御诸方 MCP 服务，一键切换，方便至极。

🛠️ 第一层：炼器准备（环境搭建）

欲炼此宝，需先备齐以下灵材，缺一不可：

1. Node.js 灵根：此乃驱动傀儡的本源之力。（请确保本地已安装 Node.js v16+）

2. CC Switch 法宝：用于管理和注入 MCP 配置。

3. 元气（网络）：首次运转需消耗天地元气下载 Chromium 躯壳。

📜 第二层：铭刻阵纹（JSON 配置）

道友请祭出 CC Switch，进入 MCP Settings（通常在右上角 Edit Config 或点击 MCP 图标）。

我们将采用最纯粹的 JSON 符文 直接注入阵眼。此法虽简，却最为稳固。

💎 核心阵图（请直接复制）

将以下代码铭刻入 mcpServers 的阵眼之中：

{
  "playwright": {
    "command": "npx",
    "args": [
      "-y",
      "@executeautomation/mcp-playwright"
    ],
    "env": {
      "PLAYWRIGHT_HEADLESS": "true"
    },
    "disabled": false,
    "autoApprove": []
  }
}

🧐 阵纹心法详解

若道友只知其然不知其所以然，易生心魔。贫道特以此界通俗语言解注：

• "command": "npx" (起灵咒) 借用 Node.js 的 npx 咒语，无需全局安装，直接从 npm 虚空召唤法身。

• "-y" (无畏印) 若天道（系统）询问“是否安装依赖”，此印可令其自动应允，免去道友分心。

• "@executeautomation/mcp-playwright" (宗门卷宗) 此乃傀儡在 ModelScope 或 NPM 宗门的真名。错一字，则招魂失败。

• "PLAYWRIGHT_HEADLESS": "true" (隐匿结界) * True (隐身)：傀儡在后台神游，无影无踪，速度极快。

  • False (现形)：若道友想亲眼看傀儡如何破阵（调试），可将其设为 false，浏览器将显化真身。

⚔️ 第三层：入阵施法（GUI 操作指南）

若道友不喜手写符文，CC Switch 亦提供了图形化炼制界面（Add Server）。请按以下心法口诀填入：

阵位 (Field)	注入灵力 (Value)	心法口诀 (Note)
Name	playwright	傀儡名讳，日后神识召唤之用
Type	stdio	标准灵力通道
Command	npx	驱动核心
Args	-y @executeautomation/mcp-playwright	切记！需分两行填入！
Env Vars	PLAYWRIGHT_HEADLESS = true	隐匿身形，节省法力

⚠️ 禁忌提醒：在 GUI 中填入 Args 时，万万不可将 -y 和包名连成一行，否则灵力紊乱，阵法必破（报错）！

⚡ 第四层：神通演练（实战测试）

阵法既成，道友记得点击 CC Switch 上的 "Sync"（同步灵气） 按钮。

随后，打开你的 AI 聊天界面（如 Claude Desktop 或 Cursor），呼唤你的 AI 器灵：

道友神识传音（Prompt）： “去，帮我用 Playwright 神游那 ModelScope 官网，截一张图回来，让我看看今日有何宝物现世！”

若配置无误，你将看到 AI 自动调用 playwright 工具，须臾之间，一张截图便会呈现在你面前。

👹 渡劫指南（常见报错与心魔）

1. 心魔一：command not found: npx * 解法：道友未种下 Node.js 灵根，或灵根未入 PATH 天地法则。速去官网下载安装。

2. 心魔二：傀儡僵直不动（Timeout） * 解法：此乃网络绝灵之地所致。道友需开启“科学飞升”通道（VPN），或在 env 中配置 HTTPS_PROXY 助其破界。

3. 心魔三：浏览器窗口一闪而过 * 解法：此乃正常现象。若想观察细节，请将 PLAYWRIGHT_HEADLESS 设为 false。

结语

大道三千，工具为舟。炼成这 CC Switch + Playwright 的组合，道友在 AI 自动化（Agentic Workflow）的修行路上便又多了一分胜算。

愿诸位道友：代码无 Bug，上线不回滚，早日飞升 P9 仙界！

本文由 CC Switch 忠实用户撰写，致敬 ModelScope 与 Playwright 宗门。