附录 A：MCP 接口（AI 自动化）

除 REST API 外，服务同时暴露了 Model Context Protocol（Streamable HTTP）端点，可被 Claude Desktop、Cursor 等支持 MCP 的客户端接入。

项	说明
Path	`/mcp`
Method	`POST`（初始化与调用）、`GET`（会话消息流）、`DELETE`（结束会话）
认证	同样需要 `api-key` 请求头
会话标识	初始化后从响应头获取 `mcp-session-id`，后续请求需回传

额外提供的自定义工具

除 Playwright MCP 自带的全部工具（导航、点击、输入、截图、快照等）外，额外提供 3 个环境管理工具：

工具名	作用	入参
getBrowserList	获取环境列表（仅返回 id / name / createdAt / group / remark）	无
launchBrowser	启动环境，并自动通过 CDP 接管该浏览器	`id`（正整数）
stopBrowser	关闭环境并断开本会话的浏览器连接	`id`（正整数）

客户端 initialize 握手，拿到 mcp-session-id；

调 launchBrowser(id) 启动环境，服务自动连接 127.0.0.1:{debuggingPort}；

直接调用 Playwright 工具操作页面；

调 stopBrowser(id) 结束。

会话断开时服务会自动断开 CDP 连接，但不会关闭浏览器；需要回收请显式调 stopBrowser。