Repolode
Enviar
microsoft

microsoft/playwright-mcp

Servidor do Model Context Protocol que permite a clientes LLM controlar um navegador real com Playwright usando snapshots estruturados de acessibilidade.

Ver no GitHubSite
Estrelas
38,397
Forks
3,288
Issues abertas
0
Último commit
ontem

O que é?

O Playwright MCP é um servidor do Model Context Protocol que oferece automação de navegador com Playwright para clientes LLM. Em vez de enviar capturas de tela para um modelo de visão, ele expõe a página como um snapshot estruturado de acessibilidade, permitindo que o modelo interaja com os elementos usando referências desse snapshot ou seletores únicos.

O servidor funciona com clientes MCP como VS Code, Cursor, Windsurf, Claude Desktop, Claude Code, Codex e Copilot, e pode ser iniciado com npx ou executado em um container Docker. As sessões do navegador podem usar um perfil persistente, um contexto isolado em memória ou se conectar a uma instância existente do Chrome ou Edge por meio de uma extensão do navegador. As opções permitem configurar o navegador, a viewport, o proxy, as listas de origens permitidas e bloqueadas, os diretórios de saída e o formato dos snapshots.

O conjunto de ferramentas inclui clicar, digitar, arrastar e soltar, enviar arquivos, preencher formulários, avaliar JavaScript, consultar mensagens do console, emular mídia e fazer buscas na página. Recursos opcionais acrescentam interações com coordenadas visuais, manipulação de PDFs e funcionalidades de devtools. O projeto ressalta que não é uma barreira de segurança.

Recursos principais

  • 01Usa snapshots de acessibilidade do Playwright em vez de capturas de tela, dispensando um modelo de visão.
  • 02Funciona com vários clientes MCP, incluindo VS Code, Cursor, Claude Desktop e Codex.
  • 03Oferece suporte a sessões persistentes, isoladas e em navegadores existentes (por meio de uma extensão).
  • 04Oferece ferramentas para clicar, preencher formulários, enviar arquivos, arrastar e soltar e avaliar JavaScript.
  • 05Disponibiliza um arquivo de configuração JSON e várias opções de linha de comando para configurar o navegador, a rede e as saídas.

Casos de uso

  • Permitir que um agente de programação com IA abra um app web, confira seu estado e verifique alterações.
  • Realizar testes exploratórios ou fluxos de testes com autorreparo conduzidos por um LLM.
  • Automatizar tarefas em navegadores com sessão iniciada, usando um perfil persistente ou um navegador conectado.
  • Executar automação de navegador headless para agentes dentro de um container Docker.

Início rápido

  1. 1

    Adicione a configuração padrão ao seu cliente MCP (executada via npx).

    npx @playwright/mcp@latest
  2. 2

    Instale o servidor Playwright MCP com o Claude Code.

    claude mcp add playwright npx @playwright/mcp@latest

Antes de usar

  • Requer Node.js 18 ou superior.
  • Foi projetado para clientes MCP, então é necessária uma ferramenta compatível com MCP para utilizá-lo.
  • O README observa que uma CLI com skills pode ser mais eficiente no uso de tokens para agentes de programação.

Tópicos

#mcp#playwright#browser-automation#llm#agent#accessibility#testing

Perguntas frequentes

O que é playwright-mcp?
Servidor do Model Context Protocol que permite a clientes LLM controlar um navegador real com Playwright usando snapshots estruturados de acessibilidade. O Playwright MCP é um servidor do Model Context Protocol que oferece automação de navegador com Playwright para clientes LLM. Em vez de enviar capturas de tela para um modelo de visão, ele expõe a página como um snapshot estruturado de acessibilidade, permitindo que o modelo interaja com os elementos usando referências desse snapshot ou seletores únicos.
playwright-mcp é gratuito? Qual é a licença?
playwright-mcp é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
playwright-mcp ainda é mantido?
Manutenção ativa. O último commit de playwright-mcp foi em 19 de out. de 2026.
Para que posso usar playwright-mcp?
Permitir que um agente de programação com IA abra um app web, confira seu estado e verifique alterações. Realizar testes exploratórios ou fluxos de testes com autorreparo conduzidos por um LLM. Automatizar tarefas em navegadores com sessão iniciada, usando um perfil persistente ou um navegador conectado. Executar automação de navegador headless para agentes dentro de um container Docker.
Como instalar playwright-mcp?
Adicione a configuração padrão ao seu cliente MCP (executada via npx).: npx @playwright/mcp@latest Instale o servidor Playwright MCP com o Claude Code.: claude mcp add playwright npx @playwright/mcp@latest
Onde consigo playwright-mcp?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/microsoft/playwright-mcp

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados