Cloudflare Playwright MCP 服务器

一个生产就绪的 Cloudflare Workers 部署，提供基于 Cloudflare 浏览器渲染服务的浏览器自动化能力给AI代理。

🚀 生产部署

生产网址: https://playwright-mcp-bjzy.bjzy.workers.dev
MCP 端点: https://playwright-mcp-bjzy.bjzy.workers.dev/mcp
旧版 SSE 端点: https://playwright-mcp-bjzy.bjzy.workers.dev/sse (不推荐使用，因为存在超时问题)

✨ 特性

• 快速且轻量级: 使用 Playwright 的可访问性树，而不是基于像素的输入
• 适合 LLM: 不需要视觉模型，完全基于结构化数据操作
• 确定性: 避免截图方法常见的模糊性
• 无服务器: 在 Cloudflare Workers 上运行，具有全球边缘部署
• 持久会话: 使用持久对象在请求间维护浏览器状态

🏗️ 架构

• Cloudflare Workers: 用于 MCP 服务器的无服务器运行时
• 浏览器渲染: 提供无头浏览器的能力
• 持久对象: 管理浏览器会话和状态
• MCP 协议: 与 AI 代理通信

🔧 快速使用

Cloudflare AI 实验室

1. 访问: https://playground.ai.cloudflare.com/
2. 设置模型为: llama-3.3-70b-instruct-fp8-fast
3. MCP 服务器网址: https://playwright-mcp-bjzy.bjzy.workers.dev/mcp
4. 连接并享受完整的浏览器自动化工具！

注意: 使用 /mcp 端点以获得可靠的 HTTP 传输。由于 Cloudflare Workers 的执行限制，/sse 端点可能会遇到连接超时问题。

示例命令

"前往 demo.playwright.dev/todomvc"
"创建一些待办事项条目"
"用海盗风格创建一个待办事项"
"截取屏幕"

📚 文档

• 部署指南: 完整的设置和部署说明
• Cloudflare 文档: 官方文档

🔄 开发工作流

此仓库遵循 GitFlow:

• main: 仅用于生产发布
• develop: 开发的默认分支
• feature/*: 新特性（从 develop 分支）
• bugfix/*: 错误修复（从 develop 分支）

本地开发

# 克隆并设置
git clone https://github.com/BrianInAz/cloudflare-playwright-mcp.git
cd cloudflare-playwright-mcp
npm install

# 创建特性分支
git checkout develop
git checkout -b feature/my-new-feature

# 部署到 Cloudflare
npm run deploy

📝 要求

• Node.js 18+
• 具有 Workers 访问权限的 Cloudflare 账户
• Wrangler CLI

🏷️ 版本控制

此项目使用语义化版本控制。查看 发布记录 获取版本历史。

📄 许可证

Apache-2.0 - 查看 LICENSE 文件获取详情。

🤝 贡献

1. 从 develop 分支创建特性分支
2. 进行更改
3. 测试部署
4. 向 develop 提交拉取请求

---

通过 ❤️ 在 Cloudflare Workers 上部署 </中文翻译>