TopGit
Đánh giá repo GitHub

Playwright MCP: một Playwright MCP server cho AI agent

microsoft/playwright-mcp
PTopGit review image for microsoft/playwright-mcp
Review by Topgit.dev for microsoft/playwright-mcp, with GitHub repository stats and README context.
Nhận định nhanh

Playwright MCP biến Claude, Cursor, VS Code và các MCP client khác thành một trình duyệt mà chúng có thể click, gõ chữ và đọc nội dung mà không cần chụp screenshot. Nó đáng cài ngay khi AI assistant cần test một UI hoặc kiểm tra một trang thực sự render ra gì, vì accessibility tree đưa cho model các phần tử có cấu trúc thay vì pixel để đoán mò. Một điểm cần biết: tài liệu của Microsoft khuyên coding agent dùng gói CLI+SKILLS riêng thay vì MCP.

Sao
★ 39.3k
Fork
⑂ 3.4k
Ngôn ngữ
TypeScript
Giấy phép
Apache-2.0
Chủ đề
AI Tools
Cập nhật
Nov 2026
Trang chủ
GitHub

Playwright MCP là gì?

Playwright MCP là một Model Context Protocol server xây trên framework Playwright của Microsoft, cho AI client tương thích MCP một trình duyệt hoạt động thật. Thay vì screenshot và vision model, nó phơi bày mỗi trang dưới dạng một accessibility tree — snapshot có cấu trúc của các nút bấm, liên kết và trường form mà LLM thao tác trực tiếp. README mô tả cách này deterministic hơn tự động hoá dựa trên pixel.

Tính năng chính

  • ✓Dùng accessibility tree của Playwright thay vì screenshot, nên không cần vision model để tìm một nút bấm hay một liên kết.
  • ✓Tool call deterministic — README nói cách này tránh được sự mập mờ thường gặp khi click dựa trên screenshot.
  • ✓`--browser` chọn chrome, firefox, webkit hoặc msedge, và server chạy ở chế độ headed mặc định trừ khi bạn truyền `--headless`.
  • ✓Persistent profile theo mặc định, nên trạng thái đăng nhập được giữ qua các phiên cho tới khi bạn tự xoá thư mục profile.
  • ✓Chế độ `--isolated` cho các phiên dùng một lần, xoá toàn bộ storage state ngay khi trình duyệt đóng lại.
  • ✓Các flag capability tuỳ chọn (`--caps vision,pdf,devtools`) mở rộng bộ tool ra ngoài phạm vi accessibility mặc định.
  • ✓Một extension Chrome/Edge cho phép server gắn vào các tab bạn đã mở sẵn, kể cả trạng thái đăng nhập.
Số sao GitHub của repo này thay đổi thế nào theo thời gian. Nguồn: star-history.com.Xem lịch sử sao ↗

Cài đặt Playwright MCP

Playwright MCP cần Node.js 18 trở lên và một MCP client — VS Code, Cursor, Windsurf, Claude Desktop, Claude Code, Goose, Grok, Junie, hoặc bất kỳ công cụ tương thích MCP nào khác. Cách cài chuẩn là thêm khối cấu hình này vào MCP config của client: ```js { "mcpServers": { "playwright": { "command": "npx", "args": ["@playwright/mcp@latest"] } } } ``` Người dùng Claude Code có thể bỏ qua JSON và chạy thẳng `claude mcp add playwright npx @playwright/mcp@latest`. VS Code, Codex, Copilot, Factory và Grok mỗi cái đều có lệnh CLI một dòng tương đương, được ghi trong README. Sau khối cấu hình đầu tiên, server nhận một danh sách dài các flag — `--browser`, `--headless`, `--isolated`, `--caps`, `--viewport-size`, `--proxy-server`, và nhiều flag khác — mỗi flag có thể đặt qua CLI arg hoặc biến môi trường, dùng để ghim một browser channel, hạn chế quyền truy cập file, hoặc định tuyến traffic qua proxy.

Dùng Playwright MCP với AI assistant của bạn

Sau khi server được đăng ký, AI assistant thấy một bộ tool trình duyệt — navigate, click, type, snapshot — và tự quyết định khi nào gọi chúng dựa trên hội thoại. Hành vi khác nhau theo từng chế độ. Persistent profile mặc định giữ bạn đăng nhập ở những site bạn đã xác thực trước đó, tiện cho việc thao tác trên tài khoản thật, nhưng hai client cùng trỏ vào một workspace sẽ tranh chấp cùng một khoá profile. Chuyển sang `--isolated` thì mỗi phiên khởi động sạch, có thể được nạp sẵn từ file `--storage-state`. Nếu bạn muốn dùng lại một cửa sổ trình duyệt đang mở, giữ nguyên tab và cookie hiện có, extension Chrome của Playwright MCP sẽ kết nối vào đó thay vì mở một instance mới. Để thiết lập thêm ngoài trạng thái đăng nhập, `--init-script` chạy một file JS trước script riêng của mỗi trang, còn `--init-page` chạy một file TypeScript trên đối tượng `page` của Playwright, một lần mỗi phiên.

Điểm mạnh

  • ✓Accessibility snapshot có cấu trúc cho model tham chiếu phần tử chính xác thay vì phải đoán toạ độ từ screenshot.
  • ✓Một lệnh `npx` cùng bốn dòng JSON là đủ để cài cho phần lớn client.
  • ✓Các flag cấu hình phủ đúng nhu cầu vận hành thật: định tuyến proxy, bỏ qua lỗi HTTPS, cấp quyền, viewport tuỳ chỉnh, và kết nối CDP tới một trình duyệt đang chạy sẵn.
  • ✓Mô hình phiên linh hoạt — persistent, isolated, hoặc gắn vào tab có sẵn qua extension — thay vì chỉ một kiểu duy nhất.

Hạn chế đã biết

  • △Chính README hướng coding agent sang gói Playwright CLI+SKILLS riêng thay vì MCP, vì lý do tốn token từ schema tool lớn và accessibility tree dài dòng.
  • △Persistent profile chỉ dùng cho một instance: hai MCP client cùng chia sẻ một workspace sẽ xung đột trừ khi bạn truyền `--isolated` hoặc một `--user-data-dir` riêng cho mỗi client.
  • △`--allowed-origins` và `--blocked-origins` được ghi rõ là không phải một ranh giới bảo mật và không có tác dụng với redirect, nên đừng dựa vào chúng để cô lập site không tin cậy.
  • △Cấu hình nằm hoàn toàn ở CLI flag và biến môi trường. Không có GUI. Muốn chọn đúng browser, viewport, quyền cấp phép thì phải đọc bảng flag.

Lựa chọn thay thế cho Playwright MCP

Ai nên dùng Playwright MCP

Playwright MCP hợp với các developer đang gắn AI assistant vào công việc liên quan trình duyệt: kỹ sư QA muốn agent thao tác thử trên một site staging, đội làm exploratory testing khi một script cố định không phù hợp, và bất kỳ ai xây workflow agentic quanh Claude, Cursor hay một MCP client khác cần đọc và hành động trên một trang thật. Nó là lựa chọn yếu hơn cho một coding agent chủ yếu sửa file và chạy test suite — chính phần so sánh trong README nói gói CLI+SKILLS riêng hợp hơn cho trường hợp thông lượng cao, context hạn chế đó.

Câu hỏi thường gặp

Sự khác biệt giữa Playwright MCP và Playwright CLI là gì?

Playwright MCP là giao diện MCP vào Playwright, được xây cho các vòng lặp agentic cần giữ trạng thái trình duyệt liên tục và suy luận lặp lại trên cấu trúc trang. README khuyên coding agent nên dùng gói Playwright CLI+SKILLS riêng thay vì MCP, vì lệnh CLI bỏ qua việc nạp schema tool lớn và accessibility tree dài dòng, giúp tiết kiệm context khi agent còn phải xử lý cả một codebase.

Những AI coding assistant nào hỗ trợ Playwright MCP?

Playwright MCP có hướng dẫn cài đặt cho VS Code, Cursor, Windsurf, Claude Desktop, Claude Code, Cline, Codex, Copilot, Factory, Gemini CLI, Goose, Grok, Junie, Kiro, LM Studio, opencode, Qodo Gen, Warp, Amp và Antigravity, cộng thêm bất kỳ client tương thích MCP nào khác dùng cùng cấu hình JSON chuẩn.

Nhiều MCP client có thể dùng Playwright MCP cùng lúc không?

Nhiều MCP client có thể dùng Playwright MCP cùng lúc, nhưng persistent profile mặc định chỉ cho phép một instance trình duyệt tại một thời điểm, nên hai client chia sẻ cùng workspace sẽ xung đột. Hãy chạy mỗi client thêm với flag `--isolated` hoặc một `--user-data-dir` riêng, hoặc dùng `--shared-browser-context` để nhiều HTTP client chủ động dùng chung một browser context.

Playwright MCP xử lý phiên trình duyệt và xác thực như thế nào?

Playwright MCP lưu trạng thái đăng nhập trong một persistent browser profile theo mặc định, nên một phiên đã xác thực một lần sẽ giữ nguyên đăng nhập ở các lượt gọi sau cho tới khi profile bị xoá. Chuyển sang chế độ `--isolated` thì toàn bộ storage state bị xoá khi trình duyệt đóng lại, dù bạn vẫn có thể nạp sẵn trạng thái qua file `--storage-state` hoặc `contextOptions` trong config.

Playwright MCP hỗ trợ những trình duyệt nào?

Playwright MCP hỗ trợ chrome, firefox, webkit và msedge, chọn qua flag `--browser` hoặc biến môi trường `PLAYWRIGHT_MCP_BROWSER`. Nó còn có tuỳ chọn `--device` để giả lập một thiết bị cụ thể và flag `--mobile` để giả lập thiết bị di động chung.

Playwright MCP có miễn phí không?

Playwright MCP miễn phí và mã nguồn mở, do Microsoft phát hành theo giấy phép Apache-2.0. Repository không mô tả gói trả phí nào — bạn cài bằng `npx` và chạy nó cục bộ trên trình duyệt của chính mình.

Vấn đề mà nó giải quyết

Các AI coding assistant đọc và viết code tốt nhưng không có cách nào sẵn có để "nhìn thấy" một trang web đã render. Một screenshot vừa tốn token của vision model vừa khiến model phải đoán toạ độ pixel cho một nút bấm có thể lệch vài pixel. Playwright MCP giải quyết một vấn đề hẹp hơn: cho MCP client cùng một góc nhìn có cấu trúc về trang mà một screen reader có được — một accessibility tree gồm các phần tử có nhãn, có thể thao tác, để model hành động trên "nút Submit" thay vì toạ độ.

Trường hợp sử dụng tốt nhất

  • •QA khám phá: cho agent trỏ vào một bản staging và để nó click qua các luồng giống một tester thật.
  • •Bảo trì test tự sửa lỗi, khi agent kiểm tra một selector bị hỏng dựa trên accessibility tree thực tế và đề xuất cách sửa.
  • •Tự động điền form và nhập liệu bằng hướng dẫn ngôn ngữ tự nhiên thay vì viết tay script Playwright.
  • •Các workflow tự trị chạy dài, cần giữ browser context xuyên suốt nhiều lượt gọi tool, đúng như phần so sánh MCP-vs-CLI của README.

Repo liên quan

Nguồn & ghi công

Các thông tin và trích dẫn trong bài này lấy từ repository GitHub microsoft/playwright-mcp và README của nó.

Dữ liệu GitHub · đồng bộ lần cuối 15 thg 8, 2026Đánh giá bởi Henry
← Về TopGit

Vẫn đang phân vân về playwright-mcp?

Một cú bấm sẽ gửi câu hỏi kèm trang này cho AI — xem AI nói gì về playwright-mcp.

GitHub