# @automatalabs/mcp-server-playwright 中文文档 规范地址：https://npmcn.com/package/%40automatalabs/mcp-server-playwright/ 版本：1\.2\.1 npm 元数据更新时间：2025-01-24T07:04:32.894Z 中文译文更新时间：2026-11-08T10:37:50.474Z 软件包许可：MIT 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40automatalabs/mcp-server-playwright 原文对照：https://npmcn.com/package/%40automatalabs/mcp-server-playwright/?lang=original 项目主页：https://automatalabs.io/ 源码仓库：https://github.com/Automata-Labs-team/MCP-Server-Playwright ## 关键信息（来自 npm 元数据） - 包体积（解压后）：34.6 kB，4 个文件 - 模块格式：ES Module - TypeScript 类型：未声明 - 运行依赖：3 个 - 首次发布：2024-12-02T08:13:15.295Z - 最新版本发布：2025-01-24T07:04:32.654Z - 近 30 天下载量：1797（2026-10-07 至 2026-11-05，npm 官方下载统计） - 已发布版本数：16（近 12 个月 0 个） ## 中文简介 使用 Playwright 用于浏览器自动化的 MCP 服务器 ## 安装 ```sh npm install @automatalabs/mcp-server-playwright ``` 也可以使用：`pnpm add @automatalabs/mcp-server-playwright`、`yarn add @automatalabs/mcp-server-playwright`、`bun add @automatalabs/mcp-server-playwright` ## README # MCP 服务器 Playwright [![MCP Playwright](https://automatalabs.io/icon.svg)](https://www.automatalabs.io/) **使用 Playwright 提供浏览器自动化功能的 模式上下文协议服务器** 启用 LLMS 与网页交互, 获取截图, 在真实的浏览器环境中执行 JavaScript [![NPM Version](https://img.shields.io/npm/v/@automatalabs/mcp-server-playwright.svg)](https://www.npmjs.com/package/@automatalabs/mcp-server-playwright) [![Downloads per month](https://img.shields.io/npm/dm/@automatalabs/mcp-server-playwright.svg)](https://npmcharts.com/compare/@automatalabs/mcp-server-playwright?minimal=true) [![License](https://img.shields.io/github/license/Automata-Labs-team/MCP-Server-Playwright.svg)](https://github.com/Automata-Labs-team/MCP-Server-Playwright/blob/main/LICENSE) [![Smithery Installs](https://smithery.ai/badge/@automatalabs/mcp-server-playwright)](https://smithery.ai/protocol/@automatalabs/mcp-server-playwright) [![MCP-Server-Playwright MCP server](https://glama.ai/mcp/servers/9q4zck8po5/badge)](https://glama.ai/mcp/servers/9q4zck8po5) ## 目录 - [特征](https://npmcn.com/package/%40automatalabs/mcp-server-playwright/#readme-features) - [安装](https://npmcn.com/package/%40automatalabs/mcp-server-playwright/#readme-installation) - [配置](https://npmcn.com/package/%40automatalabs/mcp-server-playwright/#readme-configuration) - [构成部分](https://npmcn.com/package/%40automatalabs/mcp-server-playwright/#readme-components) - [工具](https://npmcn.com/package/%40automatalabs/mcp-server-playwright/#readme-tools) - [资源](https://npmcn.com/package/%40automatalabs/mcp-server-playwright/#readme-resources) - [许可证](https://npmcn.com/package/%40automatalabs/mcp-server-playwright/#readme-license) ## 特征 - \* 完全浏览器自动化能力 - \* 截取整个页面或具体内容的屏幕截图 - 综合网络互动(导航、点击、表格填充) - 控制台日志监测 - QQ 浏览器上下文中的 JavaScript 执行 ## 安装 ### 通过 Smithery 安装 为克洛德桌面自动安装 MCP 服务器 Playwright [史密斯术](https://smithery.ai/protocol/@automatalabs/mcp-server-playwright)数字 : ```bash npx @smithery/cli install @automatalabs/mcp-server-playwright --client claude ``` 您可以使用 npx 或 mcp- get 安装软件包 : 使用 npx : ```bash npx @automatalabs/mcp-server-playwright install ``` 此命令将 : 1. 检查您的操作系统兼容性( Windows/macOS) 2. 创建或更新 Claude 配置文件 3. 配置 Playwright 服务器集成 配置文件将在 : - 窗口 : `%APPDATA%\Claude\claude_desktop_config.json` - 马可斯: `~/Library/Application Support/Claude/claude_desktop_config.json` 使用 mcp- get : ```bash npx @michaellatman/mcp-get@latest install @automatalabs/mcp-server-playwright ``` ## 配置 安装进程将自动添加到您的 Claude 配置文件中 : ```json { "mcpServers": { "playwright": { "command": "npx", "args": ["-y", "@automatalabs/mcp-server-playwright"] } } } ``` ## 构成部分 ### 工具 #### `browser_navigate` 导航到浏览器中的任何 URL ```javascript { "url": "https://stealthbrowser.cloud" } ``` #### `browser_screenshot` 抓取整个页面或特定元素的截图 ```javascript { "name": "screenshot-name", // required "selector": "#element-id", // optional "fullPage": true // optional, default: false } ``` #### `browser_click` 使用 CSS 选择器单击页面上的元素 ```javascript { "selector": "#button-id" } ``` #### `browser_click_text` 点击页面上的元素的文本内容 ```javascript { "text": "Click me" } ``` #### `browser_hover` 使用 CSS 选择器绕过页面上的元素 ```javascript { "selector": "#menu-item" } ``` #### `browser_hover_text` 以文字内容覆盖页面上的元素 ```javascript { "text": "Hover me" } ``` #### `browser_fill` 填写输入字段 ```javascript { "selector": "#input-field", "value": "Hello World" } ``` #### `browser_select` 使用 CSS 选择器在 SELECT 元素中选择一个选项 ```javascript { "selector": "#dropdown", "value": "option-value" } ``` #### `browser_select_text` 在 SELECT 元素中按其文本内容选择一个选项 ```javascript { "text": "Choose me", "value": "option-value" } ``` #### `browser_evaluate` 在浏览器控制台执行 JavaScript ```javascript { "script": "document.title" } ``` ### 资源 1. **控制台日志** (单位:千美元)`console://logs`(中文(简体) ) - 以文本格式访问浏览器控制台输出 - 包括浏览器的所有控制台消息 2. **截图** (单位:千美元)`screenshot://`(中文(简体) ) - 访问捕获截图的 PNG 图像 - 按抓取时指定的名称引用 ## 许可证 这个项目根据麻省理工学院许可证颁发——见 [自由主义](https://github.com/Automata-Labs-team/MCP-Server-Playwright/blob/main/LICENSE) 详细文件. ## 常见问题 ### @automatalabs/mcp-server-playwright 是什么？ 使用 Playwright 用于浏览器自动化的 MCP 服务器 ### 如何安装 @automatalabs/mcp-server-playwright？ 在项目目录运行 npm install @automatalabs/mcp-server-playwright，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 mcp-server-playwright，可以用 npx mcp-server-playwright 直接运行。 ### @automatalabs/mcp-server-playwright 支持 TypeScript 吗？ 该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/automatalabs\_\_mcp-server-playwright 是否存在。 ### @automatalabs/mcp-server-playwright 支持 ESM 还是 CommonJS？ 以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。 ### @automatalabs/mcp-server-playwright 可以商用吗？ @automatalabs/mcp-server-playwright 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。 ### @automatalabs/mcp-server-playwright 的下载量有多少？ 根据 npm 官方下载统计，@automatalabs/mcp-server-playwright 在 2026/10/07 – 2026/11/05 这 30 天内被下载 1,797 次，日均约 60 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @automatalabs/mcp-server-playwright 还在维护吗？ 最新版本 1\.2\.1 发布于 2025/01/24（1\.8 年前）；至今共发布 16 个版本，其中过去 12 个月发布了 0 个；首次发布于 2024/12/02。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。