CDP Bridge MCP é um serviço de ponte que conecta clientes MCP a sessões reais de navegador. Através de sua extensão Chromium acompanhante, clientes modelo podem acessar páginas do navegador, listar abas, escanear conteúdo da página, executar JavaScript, capturar capturas de tela, navegar em páginas e ler cookies.

Vídeos de Demonstração

Introdução

CDP Bridge MCP é projetado para cenários onde grandes modelos de linguagem precisam trabalhar com um navegador real. Diferente da busca HTTP sem estado, ele se conecta a páginas do navegador que já estão abertas e já logadas, podendo reutilizar o estado de login do navegador, cookies, estado da página e resultado frontend renderizado.

Repositório: https://github.com/Unagi-cq/cdp-bridge-mcp

Este projeto é escrito e distribuído em Python.

Por que CDP Bridge MCP?

Por que usar CDP Bridge MCP em vez de Playwright MCP ou Chrome DevTools MCP?

Playwright MCP e Chrome DevTools MCP são ambos poderosos, mas estão mais orientados para fluxos de trabalho como testes automatizados, depuração de protocolos ou instâncias de navegador recém-lançadas. CDP Bridge MCP tem um objetivo diferente: ele se concentra em permitir que um LLM trabalhe diretamente com a sessão real do navegador que você já está usando.

• Reutilizar o estado de login real: CDP Bridge MCP conecta-se a abas do navegador que já estão abertas e logadas. Ele pode usar diretamente cookies existentes, estado de login, contexto da página e saída frontend renderizada. Para muitos sites baseados em conta, não há necessidade de fazer login novamente ou transferir cookies manualmente.
• Melhor para colaboração diária no navegador: Playwright é uma boa opção para fluxos de automação repetíveis e scriptáveis. CDP Bridge MCP é mais adequado para tarefas interativas na página atual do usuário, como ler, analisar, verificar antes de clicar, executar scripts e tirar capturas de tela.
• Conteúdo da página otimizado para LLMs: browser_scan simplifica o HTML da página filtrando scripts, estilos e elementos invisíveis enquanto mantém texto útil, controles e estrutura, reduzindo o desperdício de tokens.
• Fluxo de inicialização leve: Uma vez publicado no PyPI, o servidor pode ser iniciado com uvx cdp-bridge. O lado do navegador só precisa da extensão carregada. Não há necessidade de escrever scripts do Playwright ou configurar parâmetros de depuração para cada instância do navegador.

Se seu objetivo é permitir que um modelo controle um navegador de automação dedicado, Playwright MCP é uma boa opção. Se seu objetivo é depurar o Chrome ou trabalhar de perto com o protocolo DevTools, Chrome DevTools MCP é uma boa opção. Se seu objetivo é permitir que um modelo leia e opere na página real do navegador que você está usando atualmente, CDP Bridge MCP está mais próximo desse cenário.

Ferramentas Disponíveis

O servidor MCP atualmente expõe estas ferramentas:

Uso

Passos de Instalação

1. Carregue a pasta da extensão do navegador src/cdp_bridge/tmwd_cdp_bridge no Chrome ou em outro navegador baseado em Chromium.
2. Configure o CDP Bridge MCP em seu cliente MCP.

Depois disso, o servidor MCP pode ser usado normalmente. Os passos detalhados estão listados abaixo.

Carregar a Extensão do Navegador

No Chrome ou em outro navegador baseado em Chromium:

1. Abra chrome://extensions/.
2. Ative o "Modo desenvolvedor".
3. Clique em "Carregar sem compactação".
4. Selecione a pasta src/cdp_bridge/tmwd_cdp_bridge.

Por padrão, a extensão se conecta ao serviço local em 127.0.0.1:18765.

Configurar MCP

Primeiro, instale uv em seu computador.

uvx foi oficialmente introduzido no uv 0.2.0. Se sua versão do uv for inferior a 0.2.0, o comando uvx pode não estar disponível. Em versões mais antigas, funcionalidades semelhantes podem ser usadas através de uv tool run, que também é o comportamento subjacente do uvx.

Teste de Script

uvx cdp-bridge # uv >= 0.2.0
uv tool run # uv < 0.2.0

Configuração Padrão

Você pode configurá-lo em um cliente MCP assim:

{
  "mcpServers": {
    "cdp-bridge": {
      "command": "uvx",
      "args": ["cdp-bridge"]
    }
  }
}

Código Claude

claude mcp add cdp-bridge uvx cdp-bridge

Codex

codex mcp add cdp-bridge uvx cdp-bridge

opencode

Configure-o em ~/.config/opencode/opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "cdp-bridge": {