CloakBrowser MCP

Servidor CloakBrowser MCP para agentes de IA: navegação com Playwright, encaminhamento limpo de ferramentas, suporte a Docker e transporte HTTP de múltiplas sessões.

GitHub
66
Experimente este MCPPatrocinado

Documentação

cloakbrowser-mcp

CloakBrowser MCP

CI codecov Actionlint CodeQL Dependency Review OpenSSF Scorecard Zizmor Release GitHub Release MCP Registry cloakbrowser-mcp MCP server Awesome MCP Servers npm npm downloads Docker Hub pulls Docker image Node.js 22.13+ or 24+ TypeScript strict Cross-platform Available on CodeGuilds MCP Server MCP transports Docker License: MIT MCP Toplist

cloakbrowser-mcp é um servidor de automação de navegador compatível com Playwright MCP, com ferramentas upstream inalteradas, CloakBrowser Chromium e empacotamento pronto para produção via npm, Docker e Streamable HTTP. Ele executa o @playwright/mcp upstream como superfície de ferramentas canônica e aponta esse runtime para o CloakBrowser.

Demonstração em 30 segundos

30-second demo showing CloakBrowser MCP startup, humanized research prompt typing, web automation, and testing workflows

Execute npx -y cloakbrowser-mcp@latest, conecte o Claude Desktop ou o Codex CLI, peça pesquisa na web, automação diária ou testes em inglês simples e inspecione o resultado real do navegador.

Documentação: swimmwatch.github.io/cloakbrowser-mcp · Comparação · Receitas

Use quando precisar de:

  • automação de navegador Playwright MCP com suporte do CloakBrowser;
  • ferramentas de navegador upstream inalteradas, além de duas ferramentas locais de introspecção;
  • instalação via npm ou Docker sobre stdio ou Streamable HTTP;
  • acesso CDP gerenciado opcional, com escopo por sessão, para clientes compatíveis com CDP por meio de chromium.connectOverCDP();
  • perfis de navegador persistentes, opções de contexto validadas e carregamento de extensões do Chrome;
  • correspondência de proxy com reconhecimento GeoIP para QA regional;
  • comportamento humanizado de mouse, teclado e rolagem para fluxos sensíveis à interação.

As verificações multiplataforma cobrem npm no Linux x64/arm64, macOS arm64/x64 e Windows x64, com Node.js 22 e 24-26. As imagens Docker são construídas e testadas com smoke tests para linux/amd64 e linux/arm64.

Consulte @playwright/mcp vs cloakbrowser-mcp ao decidir se o Playwright MCP upstream simples ou o CloakBrowser MCP atende melhor a uma implantação. As páginas de Receitas mostram caminhos de configuração focados em tarefas para perfis de login persistentes, extensões do Chrome, proxies reversos, QA regional, conexões de clientes e testes de smoke em CI.

Instalar com npm

npx -y cloakbrowser-mcp@latest

Requer Node.js 22.13+ na linha 22.x, ou Node.js 24+. Execute os diagnósticos antes de conectar um cliente:

npx -y cloakbrowser-mcp@latest doctor

Para Streamable HTTP em vez de stdio:

npx -y cloakbrowser-mcp@latest --transport streamable-http --http-port 3000

Consulte a Referência da CLI gerada para todas as flags.

Instalar com Docker

docker run --rm -i \
  -v "$PWD/artifacts:/data" \
  swimmwatch/cloakbrowser-mcp:latest

Para Streamable HTTP:

docker run --rm -p 127.0.0.1:3000:3000 \
  -v "$PWD/artifacts:/data" \
  swimmwatch/cloakbrowser-mcp:latest \
  --transport streamable-http --http-host 0.0.0.0 --http-port 3000

A imagem Docker grava artefatos em /data e é publicada para linux/amd64 e linux/arm64. Ela usa como padrão CLOAK_PLAYWRIGHT_MCP_NO_SANDBOX=true para compatibilidade com runtimes conteinerizados onde o sandboxing do Chromium geralmente não está disponível. Se o host e o runtime do contêiner suportarem sandboxing do Chromium, defina CLOAK_PLAYWRIGHT_MCP_NO_SANDBOX=false; para páginas não confiáveis, mantenha o acesso à rede do contêiner e os diretórios montados do host bem restritos. As mesmas tags também estão disponíveis em ghcr.io/swimmwatch/cloakbrowser-mcp. Consulte Docker para exemplos de perfis persistentes, montagens de extensões, HTTPS e smoke tests, ou use a receita de proxy reverso para uma implantação focada em Streamable HTTP.

Adicionar a clientes MCP

Codex CLI

codex mcp add cloakbrowser -- npx -y cloakbrowser-mcp@latest

Claude Code

claude mcp add --transport stdio cloakbrowser -- npx -y cloakbrowser-mcp@latest

GitHub Copilot no VS Code

{
  "servers": {
    "cloakbrowser": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "cloakbrowser-mcp@latest"]
    }
  }
}

Claude Desktop, Cursor, Cline, Windsurf, Warp e outros clientes mcpServers

Adicione esta entrada de servidor ao arquivo de configuração JSON do MCP do cliente:

{
  "mcpServers": {
    "cloakbrowser": {
      "command": "npx",
      "args": ["-y", "cloakbrowser-mcp@latest"]
    }
  }
}

stdio com suporte a Docker

{
  "mcpServers": {
    "cloakbrowser": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-v",
        "/tmp/cloakbrowser-artifacts:/data",
        "swimmwatch/cloakbrowser-mcp:latest"
      ]
    }
  }
}

Servidor Streamable HTTP já em execução

npx -y cloakbrowser-mcp@latest --transport streamable-http --http-port 3000
codex mcp add cloakbrowser --url http://127.0.0.1:3000/mcp
claude mcp add --transport http cloakbrowser http://127.0.0.1:3000/mcp

Prompt para um assistente de código

Cole isto no Codex, Claude Code, Copilot, Cursor, Cline, Windsurf ou em um assistente de codificação semelhante que possa editar a configuração do MCP:

Install the CloakBrowser MCP server for this workspace. Name it "cloakbrowser".
Prefer stdio with command "npx" and args ["-y", "cloakbrowser-mcp@latest"].
If this client uses VS Code mcp.json, add it under "servers" with type "stdio".
If this client uses Claude/Cursor/Cline/Windsurf/Warp-style config, add it under
"mcpServers" with the same command and args. Do not add secrets.

Mais exemplos estão em Introdução, com receitas dedicadas para Claude Desktop e Codex CLI.

Configuração

Use as variáveis PLAYWRIGHT_MCP_* upstream para configurações de navegador, artefatos, timeouts, rede e capacidades de ferramentas. Os toggles de ponte específicos do Cloak usam CLOAK_PLAYWRIGHT_MCP_*. Selecione uma build de navegador Pro Preview antes da inicialização com --release-channel preview ou CLOAK_PLAYWRIGHT_MCP_RELEASE_CHANNEL=preview; o padrão é stable.

A tabela de variáveis comuns agora está em Configuração. Essa página também cobre perfis persistentes, opções de contexto validadas, extensões do Chrome, metadados do Streamable HTTP e opções de HTTPS/auth. Consulte Correspondência de Proxy GeoIP para comportamento de proxy regional, Comportamento de Entrada Humanizada para realismo de interação e Receitas para configurações focadas em tarefas.

Compatibilidade de versões

cloakbrowser-mcp@playwright/mcpCloakBrowserNode.jsPlataforma
1.14.1^0.0.82^0.5.10`^22.13.0
1.14.0^0.0.82^0.5.10`^22.13.0
1.13.0^0.0.80^0.5.10`^22.13.0
1.12.0^0.0.79^0.5.7`^22.13.0
1.11.0^0.0.79^0.5.6`^22.13.0
1.10.0^0.0.78^0.5.3`^22.13.0
1.9.0^0.0.78^0.5.1`^22.13.0
1.8.0^0.0.78^0.4.10`^22.13.0
1.7.0^0.0.77^0.4.8>=22.12npm no Linux x64/arm64, macOS arm64/x64, Windows x64; Docker linux/amd64, linux/arm64
1.6.1^0.0.77^0.4.7>=22.12npm no Linux x64/arm64, macOS arm64/x64, Windows x64; Docker linux/amd64, linux/arm64
1.6.0^0.0.77^0.4.7>=22.12npm no Linux x64/arm64, macOS arm64/x64, Windows x64; Docker linux/amd64, linux/arm64
1.5.0^0.0.76^0.4.3>=22.12npm no Linux x64/arm64, macOS arm64/x64, Windows x64; Docker linux/amd64, linux/arm64
1.4.0^0.0.76^0.3.32>=22.12npm no Linux x64/arm64, macOS arm64/x64, Windows x64; Docker linux/amd64, linux/arm64
1.3.0^0.0.75^0.3.31>=20Docker linux/amd64, Node.js local
1.2.7^0.0.75^0.3.30>=20Docker linux/amd64, Node.js local
1.2.6^0.0.75^0.3.30>=20Docker linux/amd64, Node.js local
1.2.5^0.0.75^0.3.30>=20Docker linux/amd64, Node.js local
1.2.3^0.0.75^0.3.30>=20Docker linux/amd64, Node.js local
1.2.2^0.0.75^0.3.30>=20Docker linux/amd64, Node.js local
1.2.1^0.0.75^0.3.30>=20Docker linux/amd64, Node.js local
1.2.0^0.0.75^0.3.30>=20Docker linux/amd64, Node.js local
1.1.0^0.0.75^0.3.30>=20Docker linux/amd64, Node.js local
1.0.2^0.0.75^0.3.30>=20Docker linux/amd64, Node.js local
1.0.1^0.0.75^0.3.30>=20Docker linux/amd64, Node.js local
1.0.0^0.0.75^0.3.30>=20Docker linux/amd64, Node.js local

Consulte Compatibilidade de versões para a tabela de compatibilidade mantida.

Ferramentas

A lista de ferramentas do Playwright MCP upstream é a autoritativa. Este projeto não reimplementa nem re-documenta os schemas de navegador upstream no código-fonte.

Ferramentas locais:

  • cloakbrowser_binary_info retorna dados do pacote CloakBrowser, plataforma, cache e binário resolvido.
  • cloakbrowser_bridge_info retorna metadados da ponte, pacote/versão upstream e nomes das ferramentas locais.

Desenvolvimento

npm install
npm run build
npm test
npm run docker:build
npm run docker:smoke
npm run server:validate
npm run bridge:compare -- cloakbrowser-mcp:dev --report bridge-parity-report.json

A documentação começa em docs/getting-started.md. O material para contribuidores está agrupado em docs/contributor-guide.md.