Primeiros passos Comparação Receitas
Servidor MCP do CloakBrowser¶
cloakbrowser-mcp é um servidor de automação de navegador compatível com Playwright MCP como drop-in, com ferramentas upstream sem alterações, CloakBrowser Chromium e empacotamento pronto para npm, Docker e Streamable HTTP. Ele executa o upstream @playwright/mcp como superfície canônica de ferramentas de navegador e adiciona recursos de execução CloakBrowser orientados a implantação.
Demo de 30 segundos¶
Veja a primeira execução: inicie o pacote npm, conecte um cliente MCP, peça pesquisa na web, automação ou testes e inspecione o resultado em um navegador real.
Use quando quiser ferramentas de navegador compatíveis com Playwright MCP junto com perfis persistentes, carregamento de extensões, validação de contexto, correspondência GeoIP de proxy para QA regional ou entrada humanizada.
Versão atual: v1.7.0.
Compatibilidade de versões¶
| cloakbrowser-mcp | @playwright/mcp | Playwright MCP Docker base | CloakBrowser | Transport | Parity |
|---|---|---|---|---|---|
1.7.0 | ^0.0.77 | mcr.microsoft.com/playwright/mcp:v0.0.77 | ^0.4.8 | stdio, Streamable HTTP | Comparado no CI |
1.6.1 | ^0.0.77 | mcr.microsoft.com/playwright/mcp:v0.0.77 | ^0.4.7 | stdio, Streamable HTTP | Comparado no CI |
1.6.0 | ^0.0.77 | mcr.microsoft.com/playwright/mcp:v0.0.77 | ^0.4.7 | stdio, Streamable HTTP | Comparado no CI |
1.5.0 | ^0.0.76 | mcr.microsoft.com/playwright/mcp:v0.0.76 | ^0.4.3 | stdio, Streamable HTTP | Comparado no CI |
1.4.0 | ^0.0.76 | mcr.microsoft.com/playwright/mcp:v0.0.76 | ^0.3.32 | stdio, Streamable HTTP | Comparado no CI |
1.3.0 | ^0.0.75 | mcr.microsoft.com/playwright/mcp:v0.0.75 | ^0.3.31 | stdio, Streamable HTTP | Comparado no CI |
1.2.7 | ^0.0.75 | mcr.microsoft.com/playwright/mcp:v0.0.75 | ^0.3.30 | stdio, Streamable HTTP | Comparado no CI |
1.2.6 | ^0.0.75 | mcr.microsoft.com/playwright/mcp:v0.0.75 | ^0.3.30 | stdio, Streamable HTTP | Comparado no CI |
1.2.5 | ^0.0.75 | mcr.microsoft.com/playwright/mcp:v0.0.75 | ^0.3.30 | stdio, Streamable HTTP | Comparado no CI |
1.2.3 | ^0.0.75 | mcr.microsoft.com/playwright/mcp:v0.0.75 | ^0.3.30 | stdio, Streamable HTTP | Comparado no CI |
1.2.2 | ^0.0.75 | mcr.microsoft.com/playwright/mcp:v0.0.75 | ^0.3.30 | stdio, Streamable HTTP | Comparado no CI |
1.2.1 | ^0.0.75 | mcr.microsoft.com/playwright/mcp:v0.0.75 | ^0.3.30 | stdio, Streamable HTTP | Comparado no CI |
1.2.0 | ^0.0.75 | mcr.microsoft.com/playwright/mcp:v0.0.75 | ^0.3.30 | stdio, Streamable HTTP | Comparado no CI |
1.1.0 | ^0.0.75 | mcr.microsoft.com/playwright/mcp:v0.0.75 | ^0.3.30 | stdio, Streamable HTTP | Comparado no CI |
1.0.2 | ^0.0.75 | mcr.microsoft.com/playwright/mcp:v0.0.75 | ^0.3.30 | stdio | Comparado no CI |
1.0.1 | ^0.0.75 | mcr.microsoft.com/playwright/mcp:v0.0.75 | ^0.3.30 | stdio | Comparado no CI |
1.0.0 | ^0.0.75 | mcr.microsoft.com/playwright/mcp:v0.0.75 | ^0.3.30 | stdio | Comparado no CI |
Consulte Compatibilidade de versões para ver a correspondência atualizada entre as versões SemVer deste projeto e as versões do Playwright MCP de origem.
O que é isso?¶
- Runtime da ponte
Inicia o upstream Playwright MCP como processo filho e encaminha chamadas de ferramentas do navegador sem alterações.
- Execução do CloakBrowser
Gera uma configuração do Playwright MCP com launchOptions.executablePath apontando para o CloakBrowser.
- npm CLI
Publicado como um pacote CLI leve em Node.js para clientes MCP via stdio e Streamable HTTP.
- Imagem Docker
Baseado na imagem oficial do Playwright MCP e com pré-carregamento do cache do binário do CloakBrowser.
- Correspondência GeoIP do proxy
Alinha o fuso horário, o idioma e a localidade da impressão digital do CloakBrowser com o local do proxy configurado.
- Comportamento de entrada humanizado
Encaminha as interações da página pela camada de mouse, teclado e rolagem humanizada do CloakBrowser.
Superfície da ferramenta¶
Os contratos da ferramenta Playwright MCP, de nível superior, são os que prevalecem. Este projeto adiciona apenas duas ferramentas locais de introspecção:
cloakbrowser_binary_infocloakbrowser_bridge_info
Próximos passos¶
- Introdução para a configuração do npm, do Docker e do cliente MCP.
- Configuração para variáveis de ambiente compatíveis.
- Correspondência de proxy por GeoIP para controle de qualidade regional, metadados de proxy em tempo de execução e sessões HTTP Streamable em vários locais.
- Comportamento de entrada humanizado para realismo na interação, configuração e casos de uso.
- Ferramentas para expectativas de interface de ferramentas e paridade com o upstream.
- Perguntas frequentes para dúvidas comuns sobre instalação, Docker, paridade e segurança.
- Guia do colaborador com detalhes sobre desenvolvimento, testes, arquitetura e lançamentos.
Mais caminhos práticos¶
Para escolher entre o Playwright MCP upstream e este pacote, consulte a comparação. Para tarefas rápidas, use as receitas: perfil persistente, extensões, reverse proxy, QA regional, Claude Desktop, Codex CLI e teste smoke de CI.