Safari MCP

🦁 Safari MCP

O navegador para o seu agente de codificação.

Seu Safari real, com login feito — sem Chrome, sem aquecimento, sem headless.

97 ferramentas · Sem necessidade de Chrome/Puppeteer/Playwright · ~5ms por comando · 60% menos CPU que o Chrome

Início Rápido · Todas as 97 Ferramentas · Exemplos · Por que Safari MCP? · Arquitetura · Changelog

❌ Sem Safari MCP

Seu agente de IA precisa navegar. Então ele:

• Inicia Chromium via Playwright — sem logins, sem cookies, sem sessões
• Usa Chrome DevTools MCP — e esquenta seu ventilador rodando um segundo navegador
• Depende de scrapers headless — bloqueados por Cloudflare, reCAPTCHA e detecção de bots

✅ Com Safari MCP

Sua IA controla o Safari no qual você já está logado — Gmail, GitHub, Ahrefs, Slack, banco.

WebKit nativo. ~60% menos CPU. Operação em segundo plano. 97 ferramentas. Um comando npx. Somente macOS.

📰 Destaque no freeCodeCamp: Como Conectar Seu Agente de Codificação de IA a um Navegador no macOS · HackerNoon: Engenharia Reversa de React, Shadow DOM e CSP

🍎 A Apple lançou um Safari MCP oficial (julho de 2026 — Safari Technology Preview 247+ e o beta do Safari 27). Ele é construído sobre safaridriver para sessões de depuração isoladas. O safari-mcp controla o Safari real no qual você já está logado — no Safari estável que acompanha o macOS hoje, com 97 ferramentas. Veja a comparação completa abaixo.

Destaques

• 97 ferramentas — navegação, cliques, formulários, capturas de tela, rede, armazenamento, acessibilidade e mais
• Zero aquecimento — WebKit nativo em Apple Silicon, ~60% menos CPU que o Chrome
• Seu navegador real — mantém todos os logins, cookies, sessões (Gmail, GitHub, Ahrefs, etc.)
• Operação em segundo plano — o Safari permanece em segundo plano, sem roubar a janela
• Sem dependências de navegador — sem Puppeteer, sem Playwright, sem WebDriver, sem Chrome
• Processo persistente — reutiliza um único processo osascript (~5ms por comando vs ~80ms)
• Compatível com frameworks — preenchimento de formulários React, Vue, Angular, Svelte via setters nativos

Nas palavras dos usuários

Depoimentos não solicitados — citações retiradas do rastreador público de issues, cada uma vinculada ao tópico de onde veio.

"Eu executo várias sessões/subagentes do Pi contra meu perfil normal do Safari em paralelo. Compartilhar seus cookies e logins é intencional." — @maxim, sobre executar agentes concorrentes contra um navegador real

"O servidor tem um modelo deliberado de propriedade de abas … o código é cuidadoso com isso, e para o caso padrão essa é a postura de segurança correta." — @turner-moore, sobre por que os guardiões se recusam a tocar em suas abas

"Validação local direta do pacote: Safari MCP doctor 6/6." — @jrepp, que encontrou e corrigiu um bug de alinhamento de fila no helper de foco

Início Rápido

Pré-requisitos

• macOS (qualquer versão com Safari)
• Node.js 20+
• Safari → Ajustes → Avançado → Mostrar recursos para desenvolvedores web ✓
• Safari → Desenvolver → Permitir JavaScript de Apple Events ✓

Instalar (um comando)

npx safari-mcp

É isso — sem necessidade de instalação global. Ou instale permanentemente:

npm install -g safari-mcp

Configure seu cliente MCP

Todos os clientes executam o Safari MCP da mesma forma — npx safari-mcp. Escolha seu editor:

claude mcp add safari -- npx safari-mcp

{
  "mcpServers": {
    "safari": {
      "command": "npx",
      "args": ["safari-mcp"]
    }
  }
}

{
  "mcpServers": {
    "safari": {
      "command": "npx",
      "args": ["safari-mcp"]
    }
  }
}

{
  "mcpServers": {
    "safari": {
      "command": "npx",
      "args": ["safari-mcp"]
    }
  }
}

{
  "servers": {
    "safari": {
      "type": "stdio",
      "command": "npx",
      "args": ["safari-mcp"]
    }
  }
}

{
  "mcpServers": {
    "safari": {
      "command": "npx",
      "args": ["safari-mcp"]
    }
  }
}

{
  "mcpServers": {
    "safari": {
      "command": "npx",
      "args": ["safari-mcp"]
    }
  }
}

mcpServers:
  - name: safari
    command: npx
    args:
      - safari-mcp

extensions:
  safari:
    name: safari
    type: stdio
    cmd: npx
    args:
      - safari-mcp
    enabled: true

{
  "context_servers": {
    "safari": {
      "command": {
        "path": "npx",
        "args": ["safari-mcp"]
      }
    }
  }
}

brew install achiya-automation/tap/safari-mcp

git clone https://github.com/achiya-automation/safari-mcp.git
cd safari-mcp && npm install

Fluxo de Trabalho de Uso

O padrão recomendado para agentes de IA usando Safari MCP:

1. safari_snapshot        → Get page state (accessibility tree)
2. safari_click/fill/...  → Interact with elements by ref
3. safari_snapshot        → Verify the result

Segmentação de elementos — as ferramentas aceitam múltiplas estratégias de segmentação:

Dica: Comece com safari_snapshot para obter refs de elementos e depois use refs para segmentação precisa. Isso é mais rápido e confiável do que seletores CSS.

Executando vários agentes ao mesmo tempo

Vários agentes ou subagentes controlando um Safari ao mesmo tempo vão disputar a aba ativa — a menos que você os execute contra um daemon HTTP compartilhado em vez de um processo por cliente:

SAFARI_MCP_HTTP=1 SAFARI_MCP_HTTP_PORT=9225 npx safari-mcp

Depois aponte cada cliente para ele:

{ "mcpServers": { "safari-mcp": { "type": "http", "url": "http://127.0.0.1:9225/mcp" } } }

Um daemon, muitas sessões — e cada sessão tem seu próprio estado de aba. O servidor chaveia activeTabIndex, o sinalizador de propriedade e um marcador de aba exclusivo pelo ID da sessão MCP, então a sessão A fisicamente não consegue ler ou direcionar a aba da sessão B.

Duas propriedades tornam isso seguro em vez de apenas organizado:

• A identidade da aba é um marcador, não um índice. Cada sessão carimba um ID exclusivo na página que abre, então a propriedade sobrevive à navegação e sobrevive ao usuário reordenar ou fechar outras abas. Um índice sozinho deslizaria silenciosamente para a aba errada.

• Falha de forma fechada. Se a aba marcada de uma sessão não puder ser reencontrada, todas as ferramentas recusam em vez de recorrer a qualquer aba que esteja na frente — porque essa aba geralmente é sua:

  Tab tracking lost — refusing to fall back to "current tab of window"
  (would target the user's active tab). Call safari_new_tab to reopen.
  

Isso também reduz drasticamente a contagem de processos: ~17 processos node para 17 sessões concorrentes se tornam 1.

SAFARI_PROFILE permanece opcional — deixe desdefinido e as sessões se vinculam às suas janelas normais do Safari, com cookies e logins intactos. Detalhes em docs/http-transport-design.md.

Prefere stdio (um processo por agente) em vez de um daemon persistente? Isso também funciona — o isolamento então vem do próprio limite do processo. Uma ressalva: se seu cliente multiplexa agentes via mcporter, o mcporter armazena em cache um único cliente MCP para todos eles — independentemente do transporte escolhido — então o servidor nunca vê sessões distintas e o isolamento por sessão não pode ser ativado. mcporter-lanes (uma extensão pi de @maxim, nascida de #76) corrige isso upstream: cada sessão de agente recebe seu próprio diretório de daemon — e, portanto, seu próprio safari-mcp — com um tempo limite de inatividade para que os processos não se acumulem.

Variáveis de ambiente

SAFARI_MCP_RAISE_ON_NAVIGATE=1 é para agentes cujo objetivo principal é mostrar uma página — um assistente de voz respondendo "abra o YouTube", um driver de demonstração. Todo o resto deve deixá-lo desligado: por padrão, o Safari MCP trabalha em segundo plano e devolve o foco para qualquer aplicativo que você estava usando, para que um agente possa controlar uma página enquanto você continua digitando em outro lugar.

Ferramentas (97)

Segurança

O Safari MCP roda localmente no seu Mac com superfície de ataque mínima:

Safari MCP vs Alternativas

Dica: Use o Safari MCP para tarefas diárias de navegação (95% do trabalho) e o Chrome DevTools MCP apenas para auditorias de Lighthouse/Desempenho.

vs Safari MCP Oficial da Apple (safaridriver)

Em julho de 2026, a Apple lançou um servidor Safari MCP oficial construído sobre safaridriver — primeiro no Safari Technology Preview 247, e agora também no beta do Safari 27. Isso é uma ótima validação para a categoria — e ele foi construído para um trabalho diferente. O servidor da Apple conduz uma sessão de automação WebDriver isolada para depuração; o safari-mcp conduz o Safari real no qual você já está logado.

Ele ainda não alcançou uma versão estável do Safari: no macOS 26.5.2 com Safari 26.5.2, safaridriver --help lista --port, --bidi, --enable e --diagnose, e nenhum --mcp (verificado em 2026-07-23). Verifique sua própria máquina com safaridriver --help | grep mcp antes de assumir qualquer coisa.

Quando o servidor da Apple é a escolha certa: você especificamente quer uma sessão limpa, padrão WebDriver, para depuração de compatibilidade e já roda uma versão preview ou beta. Para todo o resto — automação diária no navegador no qual você já está logado, no Safari que veio com seu Mac — o safari-mcp é construído exatamente para isso.

Por que Safari MCP e Não os Outros Projetos Safari MCP?

Existem vários projetos "safari-mcp" por aí. Veja como eles se comparam:

Resumo — se você quer o Safari MCP mais completo com a instalação mais suave, o maior número de ferramentas e manutenção ativa, este é o escolhido.

Arquitetura

O Safari MCP usa uma arquitetura de mecanismo duplo — a Extensão é preferida por velocidade e capacidades avançadas, com AppleScript como fallback sempre disponível:

Claude/Cursor/AI Agent
        ↓ MCP Protocol (stdio)
   Safari MCP Server (Node.js)
        ↓                    ↓
   Extension (HTTP)     AppleScript + Swift daemon
   (~5-20ms/cmd)        (~5ms/cmd, always available)
        ↓                    ↓
   Content Script       do JavaScript in tab N
        ↓                    ↓
   Page DOM ←←←←←←←←←← Page DOM

Decisões de design principais:

• Motor duplo com fallback automático — A extensão é preferida; se não estiver conectada, o AppleScript cuida de tudo de forma transparente
• Auxiliar Swift persistente — um processo de longa duração em vez de criar um por comando (16x mais rápido)
• Operações indexadas por aba — todo JS roda em uma aba específica por índice, nunca rouba o foco visual
• Abordagem JS-first — digitação, cliques, upload de arquivos usam eventos JavaScript (sem conflitos de teclado com System Events)
• Sem activate — o Safari nunca é trazido para o primeiro plano

Extensão do Safari (Opcional)

A Extensão do Safari MCP é opcional, mas recomendada. Sem ela, ~80% da funcionalidade funciona apenas com AppleScript. A extensão adiciona capacidades que o AppleScript não consegue fornecer:

O que a Extensão Adiciona

Quando você precisa da extensão? Se você está automatizando SPAs modernos com shadow DOM fechado (ex.: Reddit), sites com Content Security Policy estrita, ou editores com muitos frameworks (Draft.js, ProseMirror, Slate).

Instalando a Extensão

A extensão requer uma compilação única com Xcode (gratuito, incluído no macOS).

Nota para usuários de npm: O diretório xcode/ não está incluído no pacote npm. Clone o repositório do GitHub para compilar a partir do código-fonte.

Pré-requisitos: Xcode (instale pela App Store — gratuito)

# 1. Clone the repo (the npm package does not include the Xcode project)
git clone https://github.com/achiya-automation/safari-mcp.git
cd safari-mcp

# 2. Build a clean, Apple Development-signed app
# If needed, first choose your Team in Xcode → Signing & Capabilities.
xcodebuild -project "xcode/Safari MCP/Safari MCP.xcodeproj" \
  -scheme "Safari MCP (macOS)" -configuration Release \
  -allowProvisioningUpdates clean build

# 3. Locate the signed app
APP_PATH=$(find ~/Library/Developer/Xcode/DerivedData/Safari_MCP-*/Build/Products/Release -name "Safari MCP.app" -maxdepth 2 | head -1)

# 4. Re-sign safari-helper with the Apple Events entitlement
# (helps macOS surface the TCC Automation prompt reliably)
codesign --sign - --force --entitlements safari-helper.entitlements safari-helper

# 5. Open the app (needed once so Safari registers the extension)
open "$APP_PATH"

Não faça re-assinatura ad-hoc do Safari MCP.app com codesign --deep --sign -. Isso substitui a identidade de Desenvolvimento Apple no wrapper e na extensão incorporada; o Safari atual pode silenciosamente desativar ou marcar a extensão como removida. Se uma compilação anterior foi assinada ad-hoc, execute o comando clean build acima novamente.

Alternativamente, abra xcode/Safari MCP/Safari MCP.xcodeproj diretamente no Xcode, selecione seu Apple ID em Signing & Capabilities, e clique em Run. Uma conta pessoal gratuita de Desenvolvedor Apple é suficiente para uso local.

Depois, no Safari:

1. Safari → Ajustes → Avançado → ative Mostrar recursos para desenvolvedores web
2. Safari → Desenvolver → Permitir extensões não assinadas (necessário a cada reinício do Safari)
3. Safari → Ajustes → Extensões → ative Safari MCP Bridge

A extensão conecta automaticamente ao primeiro bridge local cujo perfil do Safari declarado corresponde ao seu. As portas padrão do bridge são 9224, 9228, 9232 e 9236; uma configuração de perfil único normalmente usa 9224.

Nota: "Permitir extensões não assinadas" é redefinido toda vez que o Safari reinicia. Você precisará reativá-lo no menu Desenvolver após cada reinício. A extensão em si permanece instalada.

Status do ícone na barra de ferramentas:

• LIGADO — conectado ao servidor MCP
• DESLIGADO — desativado manualmente via popup
• (sem selo) — servidor não está rodando, reconectará automaticamente

Permissões do macOS

O Safari MCP precisa destas permissões únicas:

Concedendo Acessibilidade ao safari-helper (necessário para safari_native_*)

As ferramentas safari_native_click, safari_native_keyboard e safari_native_hover injetam eventos CGEvent no nível do SO no Safari sem roubar o foco. O macOS exige que o binário auxiliar subjacente seja aprovado em Acessibilidade antes que esses eventos possam alcançar uma janela não em primeiro plano.

1. Abra Ajustes do Sistema → Privacidade e Segurança → Acessibilidade.
2. Clique em + (desbloqueie com sua senha se necessário).
3. Navegue até o binário auxiliar e adicione-o:
   • Instalação global via npm: $(npm root -g)/safari-mcp/safari-helper
   • Instalação via npx / projeto: ./node_modules/safari-mcp/safari-helper
   • A partir do clone do código-fonte: /path/to/safari-mcp/safari-helper
4. Certifique-se de que o interruptor ao lado esteja LIGADO.

O script pós-instalação re-assina o auxiliar com um identificador estável (com.achiya-automation.safari-mcp) para que esta permissão sobreviva a futuras atualizações — sem essa etapa, cada npm update revogaria silenciosamente a aprovação porque o identificador assinado ad-hoc do binário muda a cada compilação.

Se safari_native_click relatar sucesso, mas a página não reagir (nenhum evento de clique isTrusted: true dispara), o auxiliar provavelmente está sem esta aprovação. As ferramentas safari_* (não-native_) não precisam dela.

Concedendo Automação → Safari (importante para usuários de IDE)

O TCC do macOS concede a permissão de Automação ao processo pai que inicia o servidor MCP, não ao safari-mcp em si. Portanto, você precisa conceder Automação → Safari ao aplicativo que executa Claude Code / Cursor / Windsurf — tipicamente Visual Studio Code ou Terminal.

Se o diálogo de permissão nunca aparecer automaticamente, execute este comando uma vez a partir de um Terminal que já tenha permissão de Automação:

osascript -e 'tell application "Safari" to get URL of current tab of window 1'

Essa chamada registra o aplicativo Terminal no banco de dados de Automação e então aciona o prompt para o Safari. Depois de aprovar, chamadas MCP subsequentes de qualquer cadeia de processos filhos funcionarão.

Solução de Problemas

Funciona Com

O Safari MCP funciona com qualquer cliente compatível com MCP:

Contribuindo

PRs são bem-vindos! Veja CONTRIBUTING.md para instruções de configuração.

O código-fonte são dois arquivos:

• safari.js — camada de automação do Safari (AppleScript + JavaScript)
• index.js — servidor MCP com definições de ferramentas

Patrocinadores

O Safari MCP é gratuito e de código aberto. Se ele economiza seu tempo ou ciclos de CPU, considere apoiar seu desenvolvimento:

Seu apoio financia:

• 🧪 Testes em versões do macOS e lançamentos do Safari
• 🛠️ Novas ferramentas e recursos
• 📖 Documentação e exemplos

Torne-se o primeiro patrocinador!

Suporte Comercial

Precisa integrar o Safari MCP ao seu produto ou stack de agentes? Achiya Automation oferece:

• Correções de bugs prioritárias e desenvolvimento de ferramentas personalizadas para seu caso de uso
• Consultoria de integração — conectando o Safari MCP a sistemas de agentes de produção (Claude, Cursor, n8n, personalizados)
• Suporte a implantação privada — Safari MCP multiusuário, ambientes macOS não padrão, CI/CD
• Workshops de treinamento para equipes de engenharia adotando automação baseada em MCP

Construído pelo autor do Safari MCP. Inicie uma conversa →

O que os agentes desbloqueiam com o Safari MCP

Quando um agente de IA dirige o Safari MCP, ele obtém coisas que um navegador headless não consegue:

• Sessões autenticadas reais — Gmail, GitHub, Ahrefs, Slack, painéis bancários já estão todos logados
• Preenchimento de formulários ciente de frameworks — safari_fill_and_submit chama setters React/Vue/Angular nativamente, sem adivinhar se eventos input dispararam
• Operação em segundo plano — o agente trabalha em paralelo enquanto você continua usando seu Mac
• Uma chamada MCP por fluxo de trabalho — safari_run_script agrupa navegação + cliques + extração em uma única ida e volta

O padrão se mantém entre modelos: dirija o navegador que o humano já confia — você herda logins, cookies, extensões e o ambiente exato do usuário em um único passo.

Comunidade

Mais de 6.000 downloads mensais de npm — desenvolvedores estão construindo agentes de IA no macOS com o Safari MCP.

• Discussões no GitHub — faça perguntas, compartilhe casos de uso
• Issues — relatórios de bugs e pedidos de recursos
• — comece a contribuir

Ecossistema

Outros servidores MCP para macOS que complementam o Safari MCP:

Usando Safari MCP junto com Chrome DevTools MCP? O Safari lida com 95% da navegação diária (zero overhead), o Chrome lida com os 5% que precisam de Lighthouse ou rastreamentos específicos do Chrome.

Gostou? Dê uma ⭐

Se o Safari MCP te salva do overhead do Chrome, uma estrela ajuda outros a descobrirem:

Compartilhe no Twitter/X · Compartilhe no LinkedIn · Escreva sobre isso

Listado Em

Licença

MIT — use como quiser.

Construído por Achiya Automation — automação e agentes de IA para negócios.