MCP Chrome Server

MCP Chrome Server

Um servidor Chrome baseado em MCP (Model-Controller-Prompt) para automação de navegador.

Instalação

Pré-requisitos

• Python 3.12
• Navegador Google Chrome instalado
• uv (instalador de pacotes Python) ou Docker

Instalação via Smithery

npx -y @smithery/cli install @dlwjdtn535/mcp-chrome-server --client claude

Configuração

Escolha um dos seguintes métodos de configuração com base no seu ambiente:

1. Usando uv (Recomendado)

Configuração no Windows:

{
  "mcpServers": {
    "mcp-chrome-server": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "%LOCALAPPDATA%\\Programs\\mcp-chrome-server\\src",
        "mcp-chrome-server"
      ],
      "env": {
        "CHROME_PROFILE_PATH": "%LOCALAPPDATA%\\Google\\Chrome\\User Data"
      }
    }
  }
}

Configuração no macOS:

{
  "mcpServers": {
    "mcp-chrome-server": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/usr/local/bin/mcp-chrome-server/src",
        "mcp-chrome-server"
      ],
      "env": {
        "CHROME_PROFILE_PATH": "$HOME/Library/Application Support/Google/Chrome"
      }
    }
  }
}

Configuração no Linux:

{
  "mcpServers": {
    "mcp-chrome-server": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/usr/local/bin/mcp-chrome-server/src",
        "mcp-chrome-server"
      ],
      "env": {
        "CHROME_PROFILE_PATH": "$HOME/.config/google-chrome"
      }
    }
  }
}

Configuração

Caminhos do Perfil do Chrome

Caminhos padrão do perfil do Chrome para cada sistema operacional:

SO	Caminho
Windows	%LOCALAPPDATA%\Google\Chrome\User Data
macOS	~/Library/Application Support/Google/Chrome
Linux	~/.config/google-chrome

Notas Importantes

• Feche todas as instâncias do Chrome em execução antes de iniciar o servidor de automação
• Garanta permissões adequadas para o diretório do perfil do Chrome
• Para configuração com Docker, certifique-se de que o caminho do volume montado corresponda ao caminho do perfil do Chrome do seu sistema

Gerenciamento de Credenciais

Armazene e gerencie informações de login com segurança usando o chaveiro do sistema:

# Save credentials
result = tool_save_credentials(
    site="example.com",
    username="your_username",
    password="your_password"
)

# Retrieve saved credentials
result = tool_get_credentials(
    site="example.com",
    username="your_username"
)

Principais Recursos

Controle do Navegador

# Open browser
result = tool_open_browser()

# Navigate to URL
result = tool_navigate(url="https://example.com")

# Close browser
result = tool_close_browser()

Login na Web

result = tool_web_login(
    url="https://example.com/login",
    credentials={
        "username": "your_username",
        "password": "your_password"
    },
    selectors={
        "username": "#id",
        "password": "#pw",
        "submit": ".login-button"
    }
)

Tratamento especial:

• Aguarda o usuário resolver o CAPTCHA quando detectado
• Detecção automática de autenticação de dois fatores
• Análise detalhada de cenários de falha de login

Manipulação de Elementos

# Click element
result = tool_click(selector=".button")

# Type text
result = tool_type(
    selector="#input-field",
    text="Hello, World!"
)

# Get text
result = tool_get_text(selector=".content")

# Get multiple elements
result = tool_get_elements(selector=".items")

Considerações Importantes

1. Uso do Perfil do Chrome

   • Verifique a configuração correta do caminho do perfil
   • Feche todas as outras janelas do Chrome que usam o perfil

2. Prevenção de Detecção de Automação

   • Simulação de comportamento natural do usuário
   • Mantenha atrasos apropriados entre tentativas de login

3. Segurança

   • Sempre use o chaveiro do sistema para credenciais importantes
   • Nunca exponha credenciais diretamente em variáveis de ambiente ou arquivos de configuração