使用说明
剧作家MCP服务器
使用Playwright提供浏览器自动化功能的模型上下文协议(MCP)服务器。
特性
- 浏览器管理(启动、关闭)
- 页面导航
- 元素交互(点击、键入、获取文本)
- 等待元素
- 屏幕截图
- PDF生成
- 无头和有头浏览器模式
安装
npm install
npm run build
用法
作为MCP服务器
添加到您的MCP配置文件中(例如。, ~/.cursor/mcp.json):
{
"servers": {
"playwright": {
"command": "node",
"args": ["path/to/playwright-mcp-server/dist/index.js"]
}
}
}
如果发布到npm:
{
"servers": {
"playwright": {
"command": "npx",
"args": ["playwright-mcp-server"]
}
}
}
发展
npm run dev
可用工具
browser_launch
启动一个新的浏览器实例。
headless(boolean,可选):在无头模式下运行(默认值:true)
navigate
导航到URL。
url(字符串,必填):要导航到的URL
click
单击一个元素。
selector(string,必填):元素的CSS选择器
type
在输入框中键入文本。
selector(string,必填):输入字段的CSS选择器text(字符串,必填):要键入的文本
get_text
从元素中获取文本内容。
selector(string,必填):元素的CSS选择器
screenshot
截取当前页面的屏幕截图。
path(string,必填):保存截图的文件路径fullPage(布尔值,可选):捕获整页(默认值:false)
generate_pdf
生成当前页面的PDF。
path(字符串,必填):保存PDF的文件路径format(字符串,可选):纸张格式(默认:A4)
wait_for_selector
等待元素出现。
selector(string,必填):要等待的CSS选择器timeout(数字,可选):超时时间(毫秒)(默认值:30000)
browser_close
关闭浏览器实例。
示例用法
- 启动浏览器:
browser_launch - 导航到页面:
navigate带有URL - 与元素交互:
click,type,get_text - 捕获内容:
screenshot或generate_pdf - 关闭浏览器:
browser_close
许可证
麻省理工学院