Puppeteer MCP Server Configuration & Usage Guide

Supported Clients

• Claude Desktop
• Cursor
• VS Code / Cline

Installation Command

npx -y @modelcontextprotocol/server-puppeteer

Configuration Example

{
  "mcpServers": {
    "puppeteer": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-puppeteer"
      ]
    }
  }
}

Permission Scope & Security Notes

可控制浏览器访问任意网页，不要在已登录账号的浏览器中使用

• network-access
• browser-control

Risk Score：5/10

Common Errors

Chrome 启动失败

确认系统已安装 Chrome 或 Chromium

页面加载超时

检查网络连接，或增加超时时间

sandbox 错误

Linux 下可能Required --no-sandbox 参数

Sources

• Official Documentation / Repository

Recently Verified：2026-05-18。Client versions and configuration formats may change. Please refer to official documentation before use.

Related Tools