SciF-Lin/dsh-browsercontrol-mcp ↗★ 0

dsh-browsercontrol-mcp

将Playwright浏览器控制挂载为工具 适合需要让AI代理直接驱动和操作真实浏览器进行任务的用户。

套件
dsh-browsercontrol-mcp
相容性
待驗證
Harness 依賴範圍
>=0.1.0-rc.2 <0.2.0-0 || >=0.1.1-rc.1 <0.2.0-0 || >=0.1.2-alpha.2 <0.2.0-0 || >=0.1.3-alpha.2 <0.2.0-0 || >=0.1.5-alpha.1 <0.2.0-0 || >=0.1.6-alpha.1 <0.2.0-0 || >=0.1.7-alpha.1 <0.2.0-0
Cordis 依賴範圍
^4.0.2
版本
0.1.0
授權
MIT
最近更新
2026年9月23日

安裝

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:SciF-Lin/dsh-browsercontrol-mcp

配置

改本插件那一行的 config(写在自己的 cordis.patch.yml 里,或 profile patch 里用同一个 id 定点覆盖):

键默认说明
serverNameplaywright工具名前缀:mcp____browser_navigate
modelaunchlaunch 自己开浏览器 / cdp 接管正在运行的浏览器 / extension 走浏览器扩展
browsermsedgelaunch 模式取值:chrome | msedge | firefox | webkit;cdp 模式下作为默认通道名
cdpEndpoint空cdp 目标:Chromium 通道名(msedge、msedge-beta、chrome-dev…)或 CDP URL(http://localhost:9222);空则用 browser
cdpTimeoutMs30000cdp 连接超时(毫秒)
headlessfalselaunch 模式是否无窗口
userDataDir空launch 模式的持久化 profile 目录,登录态可留存
profileDirName空extension 模式下要连接的 profile 目录名,如 Profile 1
cwd空MCP 服务进程工作目录,决定截图/快照落在哪
env{}传给 MCP 服务进程的额外环境变量
cliPath空显式指定 cli.js,绕过模块解析
extraArgs[]追加原始 CLI 参数,如 ['--caps', 'vision,devtools']
toolCallTimeoutMs120000单次工具调用超时
failOnStartupErrorfalse首次连接失败时是否让该行激活失败(默认只记录日志)

未知键会报错并跳过挂载,不会静默忽略。

注意 browser 与 cdp 通道不是同一组取值:msedge-beta / chrome-canary 这类通道只能作为 cdp 目标, 不能传给 --browser。

与手写配置共存

如果你已经在 cordis.patch.yml 手写了 mcp-playwright 行(同一个 serverName),本插件检测到后会 跳过挂载并打印一条警告,不会让启动失败。要让插件接管,请删掉那行。