网页自动化助手
使大型语言模型(LLMs)能够与网页交互、截屏以及在真实的浏览器环境中执行JavaScript。
MCP 服务配置
复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用
{
"mcpServers": {
"playwright": {
"args": [
"-y",
"@automatalabs/mcp-server-playwright"
],
"command": "npx"
}
}
}
可用工具 (10 个)
该服务在 MCP 协议中暴露的工具,AI 可按需调用
browser_navigate 1 个参数 需填 1 项
Navigate to a URL
必填参数:url
browser_screenshot 3 个参数 需填 1 项
Take a screenshot of the current page or a specific element
必填参数:name
browser_click 1 个参数 需填 1 项
Click an element on the page using CSS selector
必填参数:selector
browser_click_text 1 个参数 需填 1 项
Click an element on the page by its text content
必填参数:text
browser_fill 2 个参数 需填 2 项
Fill out an input field
必填参数:selector、value
browser_select 2 个参数 需填 2 项
Select an element on the page with Select tag using CSS selector
必填参数:selector、value
browser_select_text 2 个参数 需填 2 项
Select an element on the page with Select tag by its text content
必填参数:text、value
browser_hover 1 个参数 需填 1 项
Hover an element on the page using CSS selector
必填参数:selector
browser_hover_text 1 个参数 需填 1 项
Hover an element on the page by its text content
必填参数:text
browser_evaluate 1 个参数 需填 1 项
Execute JavaScript in the browser console
必填参数:script
服务介绍
目录
特性
- 🌐 完整的浏览器自动化功能
- 📸 截取整个页面或特定元素的屏幕截图
- 🖱️ 全面的网页交互(导航、点击、表单填写)
- 📊 控制台日志监控
- 🔧 在浏览器上下文中执行 JavaScript 代码
安装
通过 Smithery 安装
要通过 Smithery 自动为 Claude Desktop 安装 MCP Server Playwright:
npx -y @smithery/cli install @automatalabs/mcp-server-playwright --client claude
你可以使用 npx 或 mcp-get 来安装该包:
使用 npx:
npx @automatalabs/mcp-server-playwright install
此命令将:
- 检查你的操作系统兼容性(Windows/macOS)
- 创建或更新 Claude 配置文件
- 配置 Playwright 服务器集成
配置文件将自动创建/更新于:
- Windows:
%APPDATA%\Claude\claude_desktop_config.json - macOS:
~/Library/Application Support/Claude/claude_desktop_config.json
使用 mcp-get:
npx @michaellatman/mcp-get@latest install @automatalabs/mcp-server-playwright
配置
安装过程将自动在你的 Claude 配置文件中添加以下配置:
{
"mcpServers": {
"playwright": {
"command": "npx",
"args": ["-y", "@automatalabs/mcp-server-playwright"]
}
}
}
组件
工具
browser_navigate
在浏览器中导航到任意 URL
{
"url": "https://stealthbrowser.cloud"
}
browser_screenshot
捕获整个页面或特定元素的屏幕截图
{
"name": "screenshot-name", // required
"selector": "#element-id", // optional
"fullPage": true // optional, default: false
}
browser_click
使用 CSS 选择器点击页面上的元素
{
"selector": "#button-id"
}
browser_click_text
通过文本内容点击页面上的元素
{
"text": "Click me"
}
browser_hover
使用CSS选择器悬停在页面元素上
{
"selector": "#menu-item"
}
browser_hover_text
通过文本内容悬停在页面元素上
{
"text": "Hover me"
}
browser_fill
填写输入字段
{
"selector": "#input-field",
"value": "Hello World"
}
browser_select
使用CSS选择器在一个SELECT元素中选择一个选项
{
"selector": "#dropdown",
"value": "option-value"
}
browser_select_text
通过文本内容在一个SELECT元素中选择一个选项
{
"text": "Choose me",
"value": "option-value"
}
browser_evaluate
在浏览器控制台执行JavaScript代码
{
"script": "document.title"
}
资源
-
控制台日志 (
console://logs)- 以文本格式访问浏览器控制台输出
- 包括来自浏览器的所有控制台消息
-
屏幕截图 (
screenshot://<n>)- 访问捕获的屏幕截图的PNG图像
- 通过捕获时指定的名称引用
许可证
本项目根据MIT许可证发布 - 详情请参阅LICENSE文件。