浏览器自动化服务

一个提供Playwright浏览器自动化能力的MCP服务器,适用于AI助手如Augment等场景。

  • by guncha25
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 guncha25/playwright-mcp

使用说明

Playwright MCP 服务器

一个模型上下文协议(MCP)服务器,为像Augment这样的AI助手提供Playwright浏览器自动化能力。

先决条件

  • Node.js(版本14或更高)
  • npm 或 yarn 包管理器
  • Git

安装

  1. 克隆并安装:

    git clone git@github.com:guncha25/playwright-mcp.git
    cd playwright-mcp
    npm install
    
  2. 安装 Playwright 浏览器及其依赖项:

    npx playwright install
    npx playwright install-deps
    

与Augment一起设置

将此配置添加到您的增强设置中:

{
  "mcpServers": {
    "playwright": {
      "command": "npm",
      "args": [
        "run",
        "mcp"
      ]
    }
  }
}

就是这样!重启 Augment 后,您将获得浏览器自动化功能。

可用功能

一旦连接到Augment,您可以向它请求:

  • 导航至网站“打开 https://example.com”
  • 与元素互动“点击登录按钮”,“填写电子邮件字段”
  • 提取信息“获取页面标题”,“从页面中提取所有链接”
  • 截屏“对当前页面进行截图”
  • 运行自动化测试“在这个网站上测试登录流程”
  • 处理表单“填写并提交联系表”

配置

MCP服务器默认在8931端口上运行。您可以修改该端口 package.json 如有需要。

故障排除

常见问题

  1. 端口已被使用更改 package.json 中的端口号
  2. Playwright 浏览器未安装跑 npx playwright install
  3. 权限错误确保 Node.js 具有必要的权限
  4. 连接被拒绝检查MCP服务器是否正在运行以及端口是否正确

日志

要查看详细日志,您可以运行带有调试输出的MCP服务器:

DEBUG=* npm run mcp

许可证

ISC许可证

支持

对于问题和疑问: