Skip to main content
Glama

在 Render 上部署 Playwright MCP

在 Render 上部署 Playwright MCP 大概只需点击一次。你就能得到一个托管的、内置无头 Chromium 的 MCP 服务器,让你的 AI 工具通过 HTTP 驱动它——不需要在每台机器上安装本地浏览器,也不需要每次运行 npx。

Deploy to Render

https://github.com/user-attachments/assets/0f31c279-f2e0-431f-a854-50677bd800c5

功能

Playwright MCP 是一个 Model Context Protocol 服务器,它让 LLM 能打开真实浏览器、导航、点击、输入,并读取结构化辅助树快照(不是截图)的页面。它通常通过 npx @playwright/mcp 在本地运行。这个模板改成一个单一的 Render Web 服务来运行它,这样任何 MCP 客户端都可以连接到一个共享的 HTTPS URL。

它是官方 mcr.microsoft.com/playwright/mcp 镜像(自带无头 Chromium)的一个薄封装——不需要改源码。封装仅添加了 Render 必需的参数(--headless、--no-sandbox,再加上由环境提供的 --port 和 --allowed-hosts),并在服务器前面加了一个 Bearer-token 验证层,因为 Playwright MCP 本身并不支持认证。

默认开启认证。 Playwright MCP 在 HTTP 模式下没有认证功能,并且多了一个相当于 RCE 的工具,因此这个模板不会直接用默认方式开放它:请求必须携带 Authorization: Bearer $MCP_TOKEN,而 Render 会在部署时自动生成这个 token。阅读 Security 来了解它能保护什么、不能保护什么。

完整的工具列表、配置项以及客户端设置,请参阅 上游 README。

Related MCP server: Playwright MCP

架构

一个 Render Web 服务在 Bearer token 验证门后面运行官方 Playwright MCP 镜像。MCP 客户端通过 Render 的 TLS 终止边缘,以 Streamable HTTP 方式访问 /mcp;验证门检查 token 后把请求转发给 loopback 地址的 MCP 服务器,而后者会在同一容器内驱动无头 Chromium 并返回辅助树快照。

┌─────────────┐   HTTPS /mcp    ┌────────────────────────────────────────────────┐
│  MCP client │ ──────────────► │ Render web service  (Docker, standard plan)    │
│ (Claude,    │  + Bearer       │                                                │
│  Cursor, …) │    token        │  render-entrypoint.sh                          │
│             │                 │    │ reads PORT, allowed hosts                 │
│             │  Streamable     │    ▼                                           │
│             │ ◄────────────── │  render-auth-proxy.mjs   :$PORT  (public)      │
└─────────────┘   snapshots     │    │ 401 unless the Bearer token matches       │
                                │    ▼                                           │
                                │  node /app/cli.js  127.0.0.1:8931  (loopback)  │
                                │    │                                           │
                                │    ▼                                           │
                                │  headless Chromium  (baked into base image)    │
                                └────────────────────────────────────────────────┘

一次部署是如何拼装起来的:

文件

作用

render.yaml

Blueprint 脚本。声明了唯一的 Docker 服务、方案/区域、PORT 环境变量,以及自动生成的 MCP_TOKEN。Deploy 按钮读取的就是这个文件。

Dockerfile.render

基于 mcr.microsoft.com/playwright/mcp(内建 headless Chromium)的轻量封装。只添加了 entry 和验证层;不额外下载浏览器、不源码构建。

render-entrypoint.sh

读取 PORT、解析 allowed-osts 值,然后 exec 验证层,并把绑定到 loopback 的 MCP server 作为参数传给验证层。

render-auth-proxy.mjs

PID 1 进程。只依赖 Node 标准库:拒绝任何没有 Authorization: Bearer $MCP_TOKEN 的请求,并对反复猜测进行限速;转发其余请求到 127.0.0.1:8931;管理 MCP server;在 MCP server 监听之前保持公共端口关闭;并转发 SIGTERM。

render-auth-limiter.mjs

限速逻辑独立出来,因为它自己有点状态,值得单独测试。它基于固定窗口对所有客户端的认证失败次数进行限流。该文件被 proxy import,所以 Dockerfile.render 也必须复制它。

render-smoke-test.sh

构建镜像并端到端测试封装层:tom 无 MCP_TOKEN 时 close 启动;缺少 Header 时返回 401;连续错误后返回 429;用正确 token 能握手并跑一次真实 browser 工具调用;SIGTERM 后能干净退出。CI 对每个 PR 都运行它。

.env.example

记录了在本地运行容器的相同参数。

关键特性:

  • 薄封装,不改 upstream。 Playwright MCP 版本由 Dockerfile.render 的 base-image tag 固定;升级就是一个 tag 一行改动(见 Rolling Playwright MCP)。

  • No database、无持久存储、无需填入任何参数。 唯一一个 secret,MCP_TOKEN,由 Render 在部署时生成。browser 保持 upstream 默认的 persistent profile,所以 profile 可能在请求之间保存登录状态,这对只属于你自己一个有主机既是这个 template 的已知假设(见 Configuration)。

  • 鉴权,且不公开。 authentication 层由本 template 而非 upstream 提供。如果 MCP_TOKEN 未设置,container 会拒绝启动,所以不存在无鉴权匿名暴露的配置(见 Security)。

前提

部署之前,你需要:

  • 一个 Render 账号——免费创建;本身在付费 standard 实例类型上运行(见 Deploy)。

  • 一个 GitHub 账号,用来 fork 这个仓库(Deploy 按钮读取你自己仓库中的 render.yaml)。

不需要 API key 或第三方账号。 唯一的 MCP_TOKEN secret 会在部署时为你生成——你只需把它复制到 MCP client 即可(见 Deploy)。

想同时本地运行(可选——见 Run locally):

  • 安装带 BuildKit 的 Docker(Docker Desktop 4.x+ 或 Docker Engine 23+)。DGRockerfile.render 使用了 # syntax= 指令和 COPY --chmod,这些都属于 BuildKit 特性。

  • 一个 MCP client 来验证(例如 Claude Code、Cursor),或直接 curl。

你不需要 Node.js、Playwright 或本地 Chrome——base 镜像已经内置了一切。

部署

  1. 点击上方的 Deploy to Render(或 fork 本仓库并从中创建一个新的 Blueprint)。

  2. Render 读取 render.yaml,并在 标准配置中提供一个 Docker 服务(playwright-mcp)。

  3. 等待部署成功。你的服务地址为 https://<your-service>.onrender.com/mcp。

  4. 在 Dashboard 的 Environment 页面复制 MCP_TOKEN——Render 已经帮你生成了它。你的 MCP 客户端必须将它作为 Authorization: Bearer <token> 传递(见 Using the app);否则每个请求都会返回 401。

  5. 在向服务授权任何敏感数据之前,阅读 Security。token 是通往容器的唯一身份凭证,因此一定要像对待密码一样对待它——并在可能时进一步加固。

实例大小: headless Chrome 在免费/starter 实例(512MB)上可能会不足,所以 Blueprint 默认使用 standard(2GB)。确认你的任务量足够小才考虑降级。

使用应用

将你的 MCP客户端指向该服务上的 /mcp 端点,并把 MCP_TOKEN 作为 Bearer token 传入。例如,使用 Claude Code:

claude mcp add --transport http playwright https://<your-service>.onrender.com/mcp \
  --header "Authorization: Bearer <your-MCP_TOKEN>"

也可以直接把它添加到一个客户端配置文件中:

{
  "mcpServers": {
    "playwright": {
      "url": "https://<your-service>.onrender.com/mcp",
      "headers": {
        "Authorization": "Bearer <your-MCP_TOKEN>"
      }
    }
  }
}

如果客户端报告 401,说明 header 丢失或 token 与 Dashboard 中的当前不匹配。

然后请你的 assistant 浏览——例如:“打开 example.com,并给我页面标题和一些主标题。”她将会使用 Playwright MCP 工具在你的托管浏览器中执行并返回结果。

本地运行

可选部分——上的部署路径不需要任何本地环境。若你想修改 render-entrypoint.sh,在 push 之前本地模拟下会很有用。

git clone https://github.com/render-examples/playwright-mcp-render.git
cd playwright-mcp-render
cp .env.example .env          # then set MCP_TOKEN, e.g. to `openssl rand -hex 32`
docker build -f Dockerfile.render -t playwright-mcp-render .
docker run --rm --env-file .env -p 10000:10000 playwright-mcp-render

一旦容器就绪,会先打印上游自带的 Listening on …,然后是验证层的 [auth] Bearer-token gate listening …——这个顺序,是因为验证层会保持公共端口关闭,直到其背后至少 server 能接受连接为止,所以最后一行的 [attt] 才意味着服务真正 ready。(提到 [startup] 那一行的 https:// 是给部署服务上的,本地用 http 而不是。) 随后可以用一个 MCP 握手确认 server 正常——先 export 你在 .env 中执行的同一个 token,好让它下面的验证头生效:

curl -sS -X POST http://localhost:10000/mcp \
  -H "Authorization: Bearer $MCP_TOKEN" \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"1"}}}'

你应该会返回一个 serverInfo 块,其中服务名是 Playwright;去掉 Authorization 头,则应当收到 401 Unauthorized。把客户端指向 http://localhost:10000/mcp,设法就想部署后 URL 一样使用即可。

MCP_TOKEN 是唯一必须变量——没有它容器会直接退出。.env 中其他内容只是为了方便:在本地环境没有 Render 提供的 RENDER_EXTERNAL_HOSTNAME,所以 entrypoint 会自行回落到 PORT=10000 和 --allowed-hosts 区块值。

想完全跳过 Docker?上游可以这样直接运行同一个服务器:npx @playwright/mcp@latest --port 10000——不过注意这运行的是 npm 发布版本,不是本仓库固定的镜像 tag,并且它没有认证验证层(这个是本模板添加的)。这条路径也并非 Render 部署时实际运行的方式,因此在推送前请先在容器里验证。

配置

所有内容都在 render.yaml 里定义;.env.example 给出了本地运行的相同参数。

环境变量

默认值

作用

PORT

10000

auth gate 监听的端口,并且 Render 会路由到这个端口。

MCP_TOKEN

render生成

必需。 所有请求必须携带的 Bearer token。若缺少它,容器会拒绝启动。在 Dashboard 中修改该值可以轮换。

UPSTREAM_PORT

8931

MCP 服务器监听的回环端口,仅当发生冲突时才需要修改。

.env.example 还列出了 PLAYWRIGHT_MCP_HOST、PLAYWRIGHT_MCP_HEADLESS 和 PLAYWRIGHT_MCP_NO_SANDBOX。这些只有在直接运行服务器(即在此镜像之外运行)时才起作用——在 Render 上,render-entrypoint.sh 总会传入等价的 CLI 标志,而 CLI 标志优先,所以在 Render 控制面板设置这些变量不会生效。唯一的例外是 PLAYWRIGHT_MCP_ALLOWED_HOSTS,入口脚本确实会采纳它。

入口脚本通过 Render 的 RENDER_EXTERNAL_HOSTNAME 自动将服务器的 host 检查限定在你自己服务的 onrender.com 主机名内。如果你添加了自定义域名,对该域名的请求会被 host 检查拒绝,直到你设置 PLAYWRIGHT_MCP_ALLOWED_HOSTS(逗号分隔,例如 myapp.com,myapp.onrender.com;* 会关闭该检查)。

浏览器 profile 状态

入口脚本不传任何 profile 标志,因此你得到的是 Playwright MCP 的默认行为:容器文件系统上的一个持久化 profile(~/.cache/ms-playwright/mcp-*)。有两个后果值得了解:

  • 调用之间的登录状态会保留下来——这通常正是你想要的。 通过托管的浏览器认证一次,之后每次会话都复用该会话。所有指向该 URL 的客户端共享这同一个 profile,因此这隐含前提是该服务归你所有(见 Security)。没有挂载 Disk(磁盘),因此服务重启或重新部署时 profile 会被清空。

  • 并发客户端可能冲突。 上游指出,持久化 profile “一次只能由一个浏览器实例使用,因此共享同一工作区的并发 MCP 客户端会冲突”——所以两个编辑器指向同一个 URL 时可能互相冲突。扩展到多个实例后,每个实例也会获得各自的 profile。

要改变以上任何一点,请编辑 render-entrypoint.sh:

想要的

添加

每次会话一个全新的内存内 profile,关闭即废弃

--isolated

一个能跨重新部署存活的 profile(保存登录态)

一个 Render Disk 加上 --user-data-dir <mount-path>

Security

真实性披露

Playwright MCP 暴露了 browser_run_code_unsafe,上游描述它为:“运行一段 Playwright 代码。该工具是不安全的:它会在 Playwright 服务器进程中执行任意 JavaScript,相当于 R.C.E。” 在引用的版本里,它被列在 Core automation 之下,而不是某个可选能力;且 --caps 只会增加额外能力(Visual vision,&ctul <>)

公多方指定

.它将日志只取决于谁 -nem。" playaudio reason *pending

"...*移动.

`

现在到了微笑的网关other.

。

do": So, let's:

"&(That quote is fine).

Uno:

Recap(final)。</ (access.

安全

你实际运行的是什么

Playwright MCP 暴露了 browser_run_code_unsafe,上游将其描述为:“运行一段 Playwright 代码:不安全,会在 Playwright 服务器进程中执行任意 Jenkins JavaScript,等同于 RCE。" 在当前的固定版本里,它被列在Core automation(核心自动化)之下,不是某个可选择(opt-in)的能力;而--nullcaps, 只启用额外的能力(vision、dragons(如pdf‘,演 e-cool"有多个):

fine。

I输出 final answer 下. —彼的完整。

Response终不太连贯,由于中间我的草稿混乱了,现在手记下完整.env.example 还列出了 PLAYWRIGHT_MCP_HOST、PLAYWRIGHT_MCP_HEADLESS 和 PLAYWRIGHT_MCP_NO_SANDBOX。这些只有在你直接运行服务器(在此镜像之外)时才有用——在 Render 上,render-entrypoint.sh 总会等传入等价的 CLI 参数,而 CLI 参数优先,所以你在 Render 控制面板中设置它们不会起任何作用。唯一的例外是 PLAYWRIGHT_MCP_ALLOWED_HOSTS,入口脚本确实会尊从它。

入口脚本通过 Render 的 RENDER_EXTERNEL_HOSTNAME 自动将服务器的 host 检查范围限定为你服务自己的 onrender.com 主机名。如果你添加了[自定义域名],对该域名的请求会一直触发 host 检查被拒,直到你设置了 PLAYWRIGHT_MCP_ALLOWED_HOSTS(使用逗号结尾,例如 myapp.com,myapp.onrender.com;开 禁用检查)。

浏览器 profile 状态

入口脚本没有传入任何 profile 标志,所以你得到的是 Playwrite MCP(MCP)的默认:容器文件系统上的persistent profile(持久化 profile)(~/.cache/ms-playwright/mcp-*)。有两个后果值得知道:

  • 登录状态会跨调用而保留——这通常正是你想要的。 在托管的浏览器中认证一次,之后的会话都复用这个 session。所有指向同一 URL 的客户端都共享这一个 profile,所以这默认前提是这个服务属于你(见安全。没有挂载 Disk,因此重启或重新部署后 profile 会被清除。

  • 并发客户端可能冲突。 上游指出,一个 profile“一次只能被一个浏览器实例使用,因此共享同一 profile 的并发 MCP 客户端会互相冲突”——所以两个编辑器指向同一个 URL 时可能互相冲突;如果你扩容超过一个实例,每个实例也会有自己独立的 profile。

要调整其中任意一项,修改 render-entrypoint.sh:

想要

添加

每次会话一个全新的内存级 profile,关闭后即丢弃

--isolated

要一个跨重新部署仍会保留的 profile(已保存的登录)

一个 Render Disk 加上 --user-data-dir <mount-path>

(上文 mount-path 按要求保持原样)

Security

你到底在运行什么

Playwright MCP 暴露了 browser_run_code_unsafe,上游描述它:“运行一段 Playwright 代码。不安全:在 Playwright 服务器进程中执行任意的脚本,相当于获得远程代码执行(RCE)。” 在当前固定的版本中,它是列在 Core automation(核心自动化工具) 下,而非某个可选能力;并且 [--caps](https://github.com/mic/... 只会启用另外的能力(visi)。这就意味着调用方可以获得任意代码执行权限。

它不做什么

这是一个门,不是纵深防御。它不会为 RCE 做沙箱、不限已认证调用方的权限,也不提供调用方各自的身份——拥有相同 token 的调用方都是同一个主体,前述速率限制只放缓猜测,不代表已经泄的 token 不会被滥用。如果可能,在这之上再加一些更强的东西:

*看下入站 吗,见后文。

它不做什么(译文完整于上)

等等 — 下面贴到的正文。


这里我决定改用稳定输出。

最终译文(顺手复读压一次):.env.example 还列出了 PLAYWRIGHT MCP_HOST、PLAYWRIGHT MCP_HEADLESS 和 PLAYWRIGHT MCP_NO_SANDBOX。这些只有在你运行服务器服务器直接(在此镜像之外运行)时,才起作用——在 Render 上,render-entryponit.sh 总会等传入等价 CLI 标志,而 CLI 标志优先,所以你在 Render 控制台里面设置它们不会起任何作用。唯一的例外是 PLAYWRIGHT_MCP_ALLOWED_HOSTCS,入口脚本确实会采纳它。

入口脚本通过 Render 的 RENDER_EXTERNAL_HOSTNAME,自动把服务器的 host 检查限定到你服务自己的 onrender.com 域名。如果你添加了[自定义域名],未设置 PLAYWRIGHT_MCP_ALLOWED_HOSTS 时(逗号分隔,例如 *.onrender.com;*` 关闭检查?

Browser profile state

MCP 中:入口脚本不下传任何 profile 标志,故为 Playwright MCP 的默认:容器文件系统「、系统信息」上的持久化 profile(~/.cache/ms-playwright/mcp-*)。

Available Tools

23 tools
browser_clickB
Destructive

Perform click on a web page

Inputs: target (required), button, element, modifiers, +1 more.

browser_closeB
Destructive

Close the page

Inputs: no named parameters.

browser_console_messagesB
Read-only

Returns all console messages

Inputs: level (required), all, filename.

browser_dragA
Destructive

Perform drag and drop between two elements

Inputs: endTarget (required), startTarget (required), endElement, startElement.

browser_dropA
Destructive

Drop files or MIME-typed data onto an element, as if dragged from outside the page. At least one of "paths" or "data" must be provided.

Inputs: target (required), data, paths, element.

browser_evaluateB
Destructive

Evaluate JavaScript expression on page or element

Inputs: function (required), target, element, filename.

browser_file_uploadB
Destructive

Upload one or multiple files

Inputs: paths.

browser_fill_formB
Destructive

Fill multiple form fields

Inputs: fields (required).

browser_handle_dialogC
Destructive

Handle a dialog

Inputs: accept (required), promptText.

browser_hoverA
Destructive

Hover over element on page

Inputs: target (required), element.

browser_navigateC
Destructive

Navigate to a URL

Inputs: url (required).

browser_navigate_backA
Destructive

Go back to the previous page in the history

Inputs: no named parameters.

browser_network_requestA
Read-only

Returns full details (headers and body) of a single network request, or a single part if part is set. Use the number from browser_network_requests.

Inputs: index (required), part, filename.

browser_network_requestsA
Read-only

Returns a numbered list of network requests since loading the page. Use browser_network_request with the number to get full details.

Inputs: static (required), filter, filename.

browser_press_keyB
Destructive

Press a key on the keyboard

Inputs: key (required).

browser_resizeB
Destructive

Resize the browser window

Inputs: width (required), height (required).

browser_run_code_unsafeA
Destructive

Run a Playwright code snippet. Unsafe: executes arbitrary JavaScript in the Playwright server process and is RCE-equivalent.

Inputs: code, filename.

browser_select_optionB
Destructive

Select an option in a dropdown

Inputs: target (required), values (required), element.

browser_snapshotB
Read-only

Capture accessibility snapshot of the current page, this is better than screenshot

Inputs: boxes, depth, target, filename.

browser_tabsA
Destructive

List, create, close, or select a browser tab.

Inputs: action (required), url, index.

browser_take_screenshotA
Read-only

Take a screenshot of the current page. You can't perform actions based on the screenshot, use browser_snapshot for actions.

Inputs: type (required), scale (required), target, element, +2 more.

browser_typeB
Destructive

Type text into editable element

Inputs: text (required), target (required), slowly, submit, +1 more.

browser_wait_forA
Read-only

Wait for text to appear or disappear or a specified time to pass

Inputs: text, time, textGone.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.2/5.0

    Scored across 23 tools

    Disambiguation5/5

    Each tool serves a distinct browser automation purpose: navigation, actions (click, hover, drag), input (type, press_key, fill_form), page inspection (snapshot, screenshot, network/console), and session management (tabs, resize, close). No two tools overlap in function; even similar tools like browser_evaluate and browser_run_code_unsafe are clearly separated by context (page vs server).

    Naming Consistency5/5

    All 23 tools follow the consistent pattern of 'browser_' prefix followed by a lowercase snake_case verb or verb phrase (e.g., browser_navigate, browser_network_requests). The naming is uniform, descriptive, and predictable, making it easy to infer tool behavior from the name alone.

    Tool Count3/5

    At 23 tools, the count falls in the 16–25 range, which feels heavy per calibration. However, the domain of browser automation is inherently broad, and each tool addresses a specific action or inspection need. Still, the number exceeds the typical well-scoped 3–15 range, meriting a borderline score.

    Completeness4/5

    The toolset covers core browser workflows comprehensively: navigation (navigate, back), user input (click, type, press_key, select_option, fill_form), page diagnostics (snapshot, screenshot, console, network), and browser management (tabs, resize, close). Minor gaps exist (e.g., no explicit 'reload' or 'go forward' tool), but these can be handled via browser_evaluate or browser_navigate, so the surface is largely complete.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      C
      maintenance
      Enables LLMs to drive a hosted headless Chromium browser over HTTP, performing navigation, clicks, typing, and page reading through accessibility snapshots, protected by bearer-token authentication.
      23
      10,908,336 npm
      Apache 2.0
    • A
      license
      B
      quality
      B
      maintenance
      Enables AI assistants to drive a hosted headless Chromium browser over HTTP, letting them navigate pages, click, type, and read structured accessibility snapshots via the Model Context Protocol.
      23
      Apache 2.0