Chrome MCP Server

Expõe funcionalidades do navegador Chrome para assistentes de IA, permitindo automação, análise de conteúdo e busca semântica por meio de uma extensão do Chrome.

GitHub
12.5k
Experimente este MCPPatrocinado

Documentação

Chrome MCP Server 🚀

Stars License: MIT TypeScript Chrome Extension Release

🌟 Transforme seu navegador Chrome em seu assistente inteligente - Deixe a IA assumir o controle do seu navegador, transformando-o em uma poderosa ferramenta de automação controlada por IA.

📖 Documentação: English | 中文

O projeto ainda está em estágio inicial e está em desenvolvimento intensivo. Mais recursos, melhorias de estabilidade e outros aprimoramentos virão em seguida.

🎯 O que é o Chrome MCP Server?

O Chrome MCP Server é um servidor Model Context Protocol (MCP) baseado em extensão do Chrome que expõe as funcionalidades do seu navegador Chrome para assistentes de IA como o Claude, permitindo automação complexa do navegador, análise de conteúdo e busca semântica. Diferente das ferramentas tradicionais de automação de navegador (como Playwright), o Chrome MCP Server usa diretamente seu navegador Chrome do dia a dia, aproveitando hábitos, configurações e estados de login existentes do usuário, permitindo que vários modelos grandes ou chatbots assumam o controle do seu navegador e se tornem verdadeiramente seu assistente do dia a dia.

✨ Novos Recursos (2025/12/30)

  • Um Novo Editor Visual para Claude Code & Codex, para mais detalhes aqui: VisualEditor

✨ Recursos Principais

  • 😁 Agnóstico de Chatbot/Modelo: Deixe qualquer LLM, cliente de chatbot ou agente que você preferir automatizar seu navegador
  • ⭐️ Use Seu Navegador Original: Integre-se perfeitamente ao seu ambiente de navegador existente (suas configurações, estados de login, etc.)
  • 💻 Totalmente Local: Servidor MCP puramente local garantindo a privacidade do usuário
  • 🚄 Streamable HTTP: Método de conexão Streamable HTTP
  • 🏎 Entre Abas: Contexto entre abas
  • 🧠 Busca Semântica: Banco de dados vetorial integrado para descoberta inteligente de conteúdo em abas do navegador
  • 🔍 Análise Inteligente de Conteúdo: Extração de texto e correspondência de similaridade com tecnologia de IA
  • 🌐 20+ Ferramentas: Suporte para capturas de tela, monitoramento de rede, operações interativas, gerenciamento de favoritos, histórico de navegação e 20+ outras ferramentas
  • 🚀 IA Acelerada por SIMD: Otimização SIMD personalizada em WebAssembly para operações vetoriais 4-8x mais rápidas

🆚 Comparação com Projetos Similares

Dimensão de ComparaçãoServidor MCP baseado em PlaywrightServidor MCP baseado em Extensão do Chrome
Uso de Recursos❌ Requer iniciar processo de navegador independente, instalar dependências do Playwright, baixar binários do navegador, etc.✅ Não precisa iniciar processo de navegador independente, utiliza diretamente o navegador Chrome já aberto pelo usuário
Reutilização de Sessão do Usuário❌ Requer novo login✅ Usa automaticamente o estado de login existente
Ambiente do Navegador❌ Ambiente limpo sem configurações do usuário✅ Preserva totalmente o ambiente do usuário
Acesso à API⚠️ Limitado à API do Playwright✅ Acesso completo às APIs nativas do Chrome
Velocidade de Inicialização❌ Requer iniciar processo do navegador✅ Apenas precisa ativar a extensão
Velocidade de Resposta50-200ms de comunicação entre processos✅ Mais rápida

🚀 Início Rápido

Pré-requisitos

  • Node.js >= 20.0.0 e pnpm/npm
  • Navegador Chrome/Chromium

Etapas de Instalação

  1. Baixe a extensão mais recente do Chrome no GitHub

Link para download: https://github.com/hangwin/mcp-chrome/releases

  1. Instale o mcp-chrome-bridge globalmente

npm

npm install -g mcp-chrome-bridge

pnpm

# Method 1: Enable scripts globally (recommended)
pnpm config set enable-pre-post-scripts true
pnpm install -g mcp-chrome-bridge

# Method 2: Manual registration (if postinstall doesn't run)
pnpm install -g mcp-chrome-bridge
mcp-chrome-bridge register

Nota: pnpm v7+ desativa scripts de pós-instalação por padrão por segurança. A configuração enable-pre-post-scripts controla se os scripts de pré/pós-instalação são executados. Se o registro automático falhar, use o comando de registro manual acima.

  1. Carregar a Extensão do Chrome
    • Abra o Chrome e vá para chrome://extensions/
    • Ative o "Modo do desenvolvedor"
    • Clique em "Carregar sem compactação" e selecione your/dowloaded/extension/folder
    • Clique no ícone da extensão para abrir o plugin e depois clique em conectar para ver a configuração do MCP Screenshot 2025-06-09 15 52 06

Uso com Clientes de Protocolo MCP

Usando Conexão Streamable HTTP (👍🏻 Recomendado)

Adicione a seguinte configuração ao seu cliente MCP (usando CherryStudio como exemplo):

O método de conexão Streamable HTTP é recomendado

{
  "mcpServers": {
    "chrome-mcp-server": {
      "type": "streamableHttp",
      "url": "http://127.0.0.1:12306/mcp"
    }
  }
}

Usando Conexão STDIO (Alternativa)

Se o seu cliente suporta apenas o método de conexão stdio, use a seguinte abordagem:

  1. Primeiro, verifique o local de instalação do pacote npm que você acabou de instalar
# npm check method
npm list -g mcp-chrome-bridge
# pnpm check method
pnpm list -g mcp-chrome-bridge

Assumindo que o comando acima retorna o caminho: /Users/xxx/Library/pnpm/global/5 Então seu caminho final seria: /Users/xxx/Library/pnpm/global/5/node_modules/mcp-chrome-bridge/dist/mcp/mcp-server-stdio.js

  1. Substitua a configuração abaixo pelo caminho final que você obteve
{
  "mcpServers": {
    "chrome-mcp-stdio": {
      "command": "npx",
      "args": [
        "node",
        "/Users/xxx/Library/pnpm/global/5/node_modules/mcp-chrome-bridge/dist/mcp/mcp-server-stdio.js"
      ]
    }
  }
}

ex.: config em augment:

截屏2025-06-22 22 11 25

🛠️ Ferramentas Disponíveis

Lista completa de ferramentas: Lista Completa de Ferramentas

📊 Gerenciamento do Navegador (6 ferramentas)
  • get_windows_and_tabs - Listar todas as janelas e abas do navegador
  • chrome_navigate - Navegar para URLs e controlar a viewport
  • chrome_switch_tab - Alternar a aba ativa atual
  • chrome_close_tabs - Fechar abas ou janelas específicas
  • chrome_go_back_or_forward - Controle de navegação do navegador
  • chrome_inject_script - Injetar scripts de conteúdo em páginas da web
  • chrome_send_command_to_inject_script - Enviar comandos para scripts de conteúdo injetados
📸 Capturas de Tela e Visual (1 ferramenta)
  • chrome_screenshot - Captura de tela avançada com direcionamento de elementos, suporte a página inteira e dimensões personalizadas
🌐 Monitoramento de Rede (4 ferramentas)
  • chrome_network_capture_start/stop - Captura de rede via API webRequest
  • chrome_network_debugger_start/stop - API Debugger com corpos de resposta
  • chrome_network_request - Enviar requisições HTTP personalizadas
🔍 Análise de Conteúdo (4 ferramentas)
  • search_tabs_content - Busca semântica com IA entre abas do navegador
  • chrome_get_web_content - Extrair conteúdo HTML/texto de páginas
  • chrome_get_interactive_elements - Encontrar elementos clicáveis
  • chrome_console - Capturar e recuperar saída do console de abas do navegador
🎯 Interação (3 ferramentas)
  • chrome_click_element - Clicar em elementos usando seletores CSS
  • chrome_fill_or_select - Preencher formulários e selecionar opções
  • chrome_keyboard - Simular entrada de teclado e atalhos
📚 Gerenciamento de Dados (5 ferramentas)
  • chrome_history - Pesquisar histórico do navegador com filtros de tempo
  • chrome_bookmark_search - Encontrar favoritos por palavras-chave
  • chrome_bookmark_add - Adicionar novos favoritos com suporte a pastas
  • chrome_bookmark_delete - Excluir favoritos

🧪 Exemplos de Uso

A IA ajuda você a resumir o conteúdo da página da web e controla automaticamente o Excalidraw para desenhar

prompt: excalidraw-prompt Instrução: Ajude-me a resumir o conteúdo da página atual e depois desenhe um diagrama para ajudar no meu entendimento. https://www.youtube.com/watch?v=3fBPdUBWVz0

https://github.com/user-attachments/assets/fd17209b-303d-48db-9e5e-3717141df183

Após analisar o conteúdo da imagem, o LLM controla automaticamente o Excalidraw para replicar a imagem

prompt: excalidraw-prompt|content-analize Instrução: Primeiro, analise o conteúdo da imagem e depois replique a imagem combinando a análise com o conteúdo da imagem. https://www.youtube.com/watch?v=tEPdHZBzbZk

https://github.com/user-attachments/assets/60d12b1a-9b74-40f4-994c-95e8fa1fc8d3

A IA injeta scripts automaticamente e modifica estilos de páginas da web

prompt: modify-web-prompt Instrução: Ajude-me a modificar o estilo da página atual e remover anúncios. https://youtu.be/twI6apRKHsk

https://github.com/user-attachments/assets/69cb561c-2e1e-4665-9411-4a3185f9643e

A IA captura automaticamente requisições de rede para você

query: Quero saber qual é a API de busca do Xiaohongshu e como é a estrutura da resposta

https://youtu.be/1hHKr7XKqnQ

https://github.com/user-attachments/assets/dc7e5cab-b9af-4b9a-97ce-18e4837318d9

A IA ajuda a analisar seu histórico de navegação

query: Analise meu histórico de navegação do último mês

https://youtu.be/jf2UZfrR2Vk

https://github.com/user-attachments/assets/31b2e064-88c6-4adb-96d7-50748b826eae

Conversa com página da web

query: Traduza e resuma a página da web atual https://youtu.be/FlJKS9UQyC8

https://github.com/user-attachments/assets/aa8ef2a1-2310-47e6-897a-769d85489396

A IA tira capturas de tela automaticamente para você (capturas de tela de páginas da web)

query: Tire uma captura de tela da página inicial do Hugging Face https://youtu.be/7ycK6iksWi4

https://github.com/user-attachments/assets/65c6eee2-6366-493d-a3bd-2b27529ff5b3

A IA tira capturas de tela automaticamente para você (capturas de tela de elementos)

query: Capture o ícone da página inicial do Hugging Face https://youtu.be/ev8VivANIrk

https://github.com/user-attachments/assets/d0cf9785-c2fe-4729-a3c5-7f2b8b96fe0c

A IA ajuda a gerenciar favoritos

query: Adicione a página atual aos favoritos e coloque-a em uma pasta apropriada

https://youtu.be/R_83arKmFTo

https://github.com/user-attachments/assets/15a7d04c-0196-4b40-84c2-bafb5c26dfe0

Fechar páginas da web automaticamente

query: Feche todas as páginas da web relacionadas a shadcn

https://youtu.be/2wzUT6eNVg4

https://github.com/user-attachments/assets/83de4008-bb7e-494d-9b0f-98325cfea592

🤝 Contribuindo

Aceitamos contribuições! Consulte CONTRIBUTING.md para diretrizes detalhadas.

🚧 Roteiro Futuro

Temos planos empolgantes para o desenvolvimento futuro do Chrome MCP Server:

  • Autenticação
  • Gravação e Reprodução
  • Automação de Fluxos de Trabalho
  • Suporte Aprimorado a Navegadores (Extensão Firefox)

Quer contribuir com algum desses recursos? Consulte nosso Guia de Contribuição e junte-se à nossa comunidade de desenvolvimento!

📄 Licença

Este projeto é licenciado sob a Licença MIT - consulte o arquivo LICENSE para obter detalhes.

📚 Mais Documentação