Safari MCP

🦁 Safari MCP

El navegador para tu agente de código.

Tu Safari real, con sesión iniciada — sin Chrome, sin calor, sin headless.

Instalar en VS Code · VS Code Insiders · Instalar en Cursor

98 herramientas · Sin necesidad de Chrome/Puppeteer/Playwright · ~5ms por comando · 60% menos CPU que Chrome

Inicio rápido · Las 98 herramientas · Ejemplos · ¿Por qué Safari MCP? · Arquitectura · Registro de cambios

❌ Sin Safari MCP

Tu agente de IA necesita navegar. Así que o bien:

• Inicia Chromium vía Playwright — sin inicios de sesión, sin cookies, sin sesiones
• Usa Chrome DevTools MCP — y funde el ventilador ejecutando un segundo navegador
• Depende de scrapers headless — bloqueados por Cloudflare, reCAPTCHA y detección de bots

✅ Con Safari MCP

Tu IA controla el Safari en el que ya has iniciado sesión — Gmail, GitHub, Ahrefs, Slack, banca.

WebKit nativo. ~60% menos CPU. Operación en segundo plano. 98 herramientas. Un comando npx. Solo macOS.

📰 Destacado en freeCodeCamp: Cómo conectar tu agente de código de IA a un navegador en macOS · HackerNoon: Ingeniería inversa de React, Shadow DOM y CSP

🍎 Apple incluye un Safari MCP oficial — safaridriver --mcp, primero en Safari Technology Preview 247 (julio de 2026) y en Safari estable desde 27.0. Controla una sesión de automatización aislada para depuración. safari-mcp controla el Safari real en el que ya has iniciado sesión — tus cookies y sesiones, en segundo plano, con 98 herramientas. Consulta la comparación completa a continuación.

Destacados

• 98 herramientas — navegación, clics, formularios, capturas de pantalla, red, almacenamiento, accesibilidad y más
• Cero calor — WebKit nativo en Apple Silicon, ~60% menos CPU que Chrome
• Tu navegador real — conserva todos los inicios de sesión, cookies y sesiones (Gmail, GitHub, Ahrefs, etc.)
• Operación en segundo plano — Safari permanece en segundo plano, sin robar ventanas
• Sin dependencias de navegador — sin Puppeteer, sin Playwright, sin WebDriver, sin Chrome
• Proceso persistente — reutiliza un único proceso osascript (~5ms por comando vs ~80ms)
• Compatible con frameworks — relleno de formularios en React, Vue, Angular, Svelte mediante setters nativos

En palabras de los usuarios

Testimonios no solicitados — citas extraídas del rastreador de incidencias público, cada una enlazada al hilo del que proviene.

"Ejecuto múltiples sesiones de Pi/subagentes contra mi perfil normal de Safari en paralelo. Compartir sus cookies e inicios de sesión es intencional." — @maxim, sobre ejecutar agentes concurrentes contra un navegador real

"El servidor tiene un modelo deliberado de propiedad de pestañas … el código es cuidadoso con esto, y para el caso predeterminado esa es la postura de seguridad correcta." — @turner-moore, sobre por qué los guardias se niegan a tocar tus pestañas

"Validación local directa desde el paquete: Safari MCP doctor 6/6." — @jrepp, quien encontró y corrigió un error de alineación de cola en el helper de enfoque

Inicio rápido

Requisitos previos

• macOS (cualquier versión con Safari)
• Node.js 20+
• Safari → Ajustes → Avanzado → Mostrar funciones para desarrolladores web ✓
• Safari → Ajustes → Desarrollador → Permitir JavaScript desde Apple Events ✓

Instalación (un comando)

npx safari-mcp

Eso es todo — no se necesita instalación global. O instala permanentemente:

npm install -g safari-mcp

Configura tu cliente MCP

Todos los clientes ejecutan Safari MCP de la misma manera — npx safari-mcp. Elige tu 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

Flujo de trabajo de uso

El patrón recomendado para agentes de IA que usan 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

Selección de elementos — las herramientas aceptan múltiples estrategias de selección:

Consejo: Comienza con safari_snapshot para obtener refs de elementos, luego usa refs para una selección precisa. Esto es más rápido y fiable que los selectores CSS.

Ejecutar varios agentes a la vez

Múltiples agentes o subagentes que controlan un mismo Safari al mismo tiempo competirán por la pestaña activa — a menos que los ejecutes contra un daemon HTTP compartido en lugar de un proceso por cliente:

SAFARI_MCP_HTTP=1 SAFARI_MCP_HTTP_PORT=9225 npx safari-mcp

Luego apunta cada cliente a él:

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

Un daemon, muchas sesiones — y cada sesión obtiene su propio estado de pestaña. El servidor vincula activeTabIndex, el indicador de propiedad y un marcador único de pestaña al id de sesión MCP, por lo que la sesión A físicamente no puede leer ni dirigir la pestaña de la sesión B.

Dos propiedades hacen que esto sea seguro en lugar de meramente ordenado:

• La identidad de pestaña es un marcador, no un índice. Cada sesión sella un id único en la página que abre, por lo que la propiedad sobrevive a la navegación y sobrevive a que el usuario reordene o cierre otras pestañas. Un índice solo se desviaría silenciosamente hacia la pestaña equivocada.

• Falla de forma cerrada. Si la pestaña marcada de una sesión no se puede reencontrar, cada herramienta se niega en lugar de recurrir a la pestaña que esté al frente — porque esa pestaña suele ser tuya:

  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.
  

Esto también reduce drásticamente el número de procesos: ~17 procesos node para 17 sesiones concurrentes se convierte en 1.

SAFARI_PROFILE sigue siendo opcional — déjalo sin establecer y las sesiones se vinculan a tus ventanas normales de Safari, con cookies e inicios de sesión intactos. Detalles en docs/http-transport-design.md.

¿Prefieres stdio (un proceso por agente) sobre un daemon persistente? Eso también funciona — el aislamiento entonces proviene del propio límite del proceso. Una advertencia: si tu cliente multiplexa agentes a través de mcporter, mcporter almacena en caché un único cliente MCP para todos ellos — sea cual sea el transporte que elijas — por lo que el servidor nunca ve sesiones distintas y el aislamiento por sesión no puede activarse. mcporter-lanes (una extensión de pi por @maxim, nacida de #76) corrige esto aguas arriba: cada sesión de agente obtiene su propio directorio de daemon — y por lo tanto su propio safari-mcp — con un tiempo de espera de inactividad para que los procesos no se acumulen.

Actuar sobre una pestaña que ya tienes abierta

Por defecto, el servidor solo toca las pestañas que él mismo abrió. Apúntalo a una de las tuyas y se niega:

Tab safety: refusing "click" — current tab (https://mail.example.com/inbox) was not
opened by this MCP session. Use safari_new_tab or safari_switch_tab to target your own tab.

Ese valor predeterminado existe porque las primeras versiones sí hacían clic y cerraban las pestañas de la gente. Pero "leer el artículo que estoy mirando" y "rellenar el formulario en mi pantalla" son casos reales, y reabrir la página pierde el estado de sesión que hacía valiosa tu pestaña. Establece SAFARI_MCP_ALLOW_USER_TABS=1 y un safari_switch_tab explícito adopta la pestaña en lugar de rechazarla; a partir de entonces la sesión trabaja en ella como si fuera propia, y así lo indica:

{ "tabIndex": 3, "safeUrl": "https://mail.example.com/inbox", "note": "(user tab, opted-in)" }

Lo que el indicador deliberadamente no hace:

• Desbloquea la adopción, no los guardias. Solo safari_switch_tab adopta, y solo la pestaña que nombraste. Un clic o navegación ordinaria nunca aterriza en la pestaña que esté al frente — el servidor actúa sobre la pestaña a la que lo apuntaste, no a la que te desplazaste.
• safari_close_tab sigue rechazándose. Cerrar es la única acción cuyo costo no se puede deshacer, por lo que una pestaña adoptada es escribible, nunca desechable. Ciérrala tú mismo.
• La adopción es local a la sesión. Nada se escribe en el archivo de propiedad compartido, por lo que termina con la sesión en lugar de filtrarse al siguiente proceso en la máquina.

safari_doctor imprime el estado del indicador, y cada operación en una pestaña adoptada registra (user tab, opted-in) — por lo que "por qué tocó mi pestaña" tiene una respuesta en lugar de ser un misterio. Desactivado por defecto; establécelo solo para agentes que quieras que trabajen dentro de tu propia sesión de navegación. Diseñado en #92.

Variables de entorno

SAFARI_MCP_RAISE_ON_NAVIGATE=1 es para agentes cuyo propósito principal es mostrarte una página — un asistente de voz que responde "abre YouTube", un controlador de demostración. Todo lo demás debería dejarlo desactivado: por defecto Safari MCP trabaja en segundo plano y devuelve el enfoque a la aplicación que estabas usando, por lo que un agente puede controlar una página mientras sigues escribiendo en otro lugar.

Herramientas (98)

Seguridad

Safari MCP se ejecuta localmente en tu Mac con una superficie de ataque mínima:

Safari MCP frente a alternativas

Consejo: Usa Safari MCP para tareas diarias de navegación (95 % del trabajo) y Chrome DevTools MCP solo para auditorías de Lighthouse/Rendimiento.

Frente al Safari MCP oficial de Apple (safaridriver)

En julio de 2026, Apple lanzó un servidor Safari MCP oficial basado en safaridriver: primero en Safari Technology Preview 247 y en Safari estable desde la versión 27.0. Es una gran validación para la categoría, y está diseñado para un trabajo diferente. El servidor de Apple impulsa una sesión de automatización WebDriver aislada para depuración; safari-mcp impulsa el Safari real en el que ya has iniciado sesión.

En macOS 27.0 con Safari 27.0, safaridriver --help lista --mcp y su tools/list responde con 17 entradas (verificado el 15-09-2026); Safari 26.5.2 no tenía --mcp (verificado el 23-07-2026). Comprueba tu propia máquina con safaridriver --help | grep mcp.

¿Ejecutando ambos? La guía de configuración de Apple registra su servidor con el nombre safari-mcp (claude mcp add safari-mcp -- /usr/bin/safaridriver --mcp), el mismo nombre que este paquete. Asigna a uno de ellos un nombre diferente, p. ej., claude mcp add safari-webdriver -- /usr/bin/safaridriver --mcp, para que tu cliente no sobrescriba uno con el otro ni te deje adivinando qué servidor respondió.

Acerca de la fila navigator.webdriver: el estándar WebDriver requiere que cada sesión controlada remotamente informe true, por lo que el servidor de Apple lo hace. safari-mcp evalúa JavaScript en una pestaña ordinaria, por lo que lee false (verificado en Safari 27.0, 2026-09-17). Esa es la diferencia si un sitio rechaza el tráfico de WebDriver. No es una función anti-detección — nada más sobre el navegador está disfrazado, y tus inicios de sesión reales están en uso, así que trata cada página como si supiera exactamente quién eres.

Cuándo elegir el servidor de Apple: específicamente quieres una sesión limpia, estándar WebDriver para depuración de compatibilidad en Safari 27 o posterior. Para todo lo demás — automatización diaria en el navegador donde ya has iniciado sesión, en segundo plano — safari-mcp está construido exactamente para eso.

¿Por qué Safari MCP y no los otros proyectos Safari MCP?

Hay varios proyectos "safari-mcp" por ahí. Así se comparan:

TL;DR — si quieres el Safari MCP más completo con la instalación más fluida, la mayor cantidad de herramientas y mantenimiento activo, este es el indicado.

Arquitectura

Safari MCP utiliza una arquitectura de doble motor — la Extensión es preferida por velocidad y capacidades avanzadas, con AppleScript como respaldo siempre disponible:

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

Decisiones clave de diseño:

• Doble motor con respaldo automático — la Extensión es preferida; si no está conectada, AppleScript maneja todo sin problemas
• Helper Swift persistente — un proceso de larga duración en lugar de generar uno por comando (16 veces más rápido)
• Operaciones indexadas por pestaña — todo el JS se ejecuta en una pestaña específica por índice, nunca roba el foco visual
• Enfoque JS primero — escribir, hacer clic, subir archivos usan eventos de JavaScript (sin conflictos de teclado con System Events)
• Sin activate — Safari nunca se trae al primer plano

Extensión de Safari (Opcional)

La Extensión de Safari MCP es opcional pero recomendada. Sin ella, ~80% de la funcionalidad funciona solo con AppleScript. La extensión añade capacidades que AppleScript no puede proporcionar:

Lo que añade la Extensión

¿Cuándo necesitas la extensión? Si automatizas SPAs modernos con shadow DOM cerrado (por ejemplo, Reddit), sitios con Política de Seguridad de Contenido estricta, o editores con mucho framework (Draft.js, ProseMirror, Slate).

Instalando la Extensión

La extensión requiere una compilación única con Xcode (gratis, incluido con macOS).

Nota para usuarios de npm: El directorio xcode/ no está incluido en el paquete npm. Clona el repositorio de GitHub para compilar desde el código fuente.

Requisitos previos: Xcode (instalar desde App Store — gratis)

# 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"

No vuelvas a firmar ad-hoc Safari MCP.app con codesign --deep --sign -. Eso reemplaza la identidad de Desarrollo de Apple en el wrapper y la extensión integrada; Safari actual puede entonces deshabilitar silenciosamente o marcar la extensión como eliminada. Si una compilación anterior fue firmada ad-hoc, ejecuta el comando clean build de nuevo.

Alternativamente, abre xcode/Safari MCP/Safari MCP.xcodeproj directamente en Xcode, selecciona tu Apple ID en Signing & Capabilities, y haz clic en Run. Una cuenta gratuita de desarrollador personal de Apple es suficiente para uso local.

Luego en Safari:

1. Safari → Ajustes → Avanzado → activa Mostrar funciones para desarrolladores web
2. Safari → Ajustes → Desarrollador → Permitir extensiones sin firmar (requerido en cada reinicio de Safari)
3. Safari → Ajustes → Extensiones → activa Safari MCP Bridge

La extensión se conecta automáticamente al primer bridge local cuyo perfil de Safari declarado coincida con el suyo. Los puertos de bridge predeterminados son 9224, 9228, 9232 y 9236; una configuración de perfil único normalmente usa 9224.

Nota: "Permitir extensiones sin firmar" se restablece cada vez que Safari se reinicia. Deberás volver a activarlo en Safari → Ajustes → Desarrollador después de cada reinicio. La extensión en sí permanece instalada.

Estado del icono de la barra de herramientas:

• ON — conectado al servidor MCP
• OFF — deshabilitado manualmente vía popup
• (sin insignia) — el servidor no está ejecutándose, se reconectará automáticamente

Permisos de macOS

Safari MCP necesita estos permisos únicos:

Otorgando Accesibilidad a safari-helper (requerido para safari_native_*)

Las herramientas safari_native_click, safari_native_keyboard y safari_native_hover inyectan eventos CGEvent a nivel de SO en Safari sin robar el foco. macOS requiere que el binario helper subyacente sea aprobado en Accesibilidad antes de que esos eventos puedan llegar a una ventana que no está en primer plano.

1. Abre Ajustes del Sistema → Privacidad y Seguridad → Accesibilidad (en macOS 27 el panel se llama Control de dispositivos y acceso a datos).
2. Haz clic en + (desbloquea con tu contraseña si es necesario).
3. Navega al binario helper y agrégalo:
   • Instalación global npm: $(npm root -g)/safari-mcp/safari-helper
   • Instalación npx / proyecto: ./node_modules/safari-mcp/safari-helper
   • Desde clon del código fuente: /path/to/safari-mcp/safari-helper
4. Asegúrate de que el interruptor junto a él esté ON.

El script postinstall vuelve a firmar el helper con un identificador estable (com.achiya-automation.safari-mcp) para que este permiso sobreviva a futuras actualizaciones — sin ese paso, cada npm update revocaría silenciosamente la aprobación porque el identificador firmado ad-hoc del binario cambia por compilación.

Si safari_native_click informa éxito pero la página no reacciona (no se disparan eventos de clic isTrusted: true), lo más probable es que al helper le falte esta aprobación. Las herramientas safari_* (no native_) no la necesitan.

Otorgando Automatización → Safari (importante para usuarios de IDE)

macOS TCC otorga el permiso de Automatización al proceso padre que genera el servidor MCP, no a safari-mcp en sí. Así que necesitas otorgar Automatización → Safari a la aplicación que ejecuta Claude Code / Cursor / Windsurf — típicamente Visual Studio Code o Terminal.

Si el diálogo de permiso nunca aparece automáticamente, ejecuta este comando una vez desde una Terminal que ya tenga permiso de Automatización:

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

Esa llamada registra la aplicación Terminal en la base de datos de Automatización y luego activa el aviso para Safari. Después de que lo apruebes, las llamadas MCP posteriores desde cualquier cadena de procesos hijo funcionarán.

Solución de problemas

FAQ

Funciona con

Safari MCP funciona con cualquier cliente compatible con MCP:

Contribuciones

¡Las solicitudes de extracción son bienvenidas! Consulta CONTRIBUTING.md para instrucciones de configuración.

El código base son dos archivos:

• safari.js — capa de automatización de Safari (AppleScript + JavaScript)
• index.js — servidor MCP con definiciones de herramientas

Patrocinadores

Safari MCP es gratuito y de código abierto. Si te ahorra tiempo o ciclos de CPU, considera apoyar su desarrollo:

Tu apoyo financia:

• 🧪 Pruebas en varias versiones de macOS y lanzamientos de Safari
• 🛠️ Nuevas herramientas y funciones
• 📖 Documentación y ejemplos

¡Conviértete en el primer patrocinador!

Soporte comercial

¿Necesitas integrar Safari MCP en tu producto o pila de agentes? Achiya Automation ofrece:

• Correcciones de errores prioritarias y desarrollo de herramientas personalizadas para tu caso de uso
• Consultoría de integración: conexión de Safari MCP en sistemas de agentes de producción (Claude, Cursor, n8n, personalizados)
• Soporte de implementación privada: Safari MCP multiusuario, entornos macOS no estándar, CI/CD
• Talleres de capacitación para equipos de ingeniería que adoptan automatización basada en MCP

Creado por el autor de Safari MCP. Inicia una conversación →

Lo que los agentes desbloquean con Safari MCP

Cuando un agente de IA maneja Safari MCP, obtiene cosas que un navegador sin interfaz no puede:

• Sesiones autenticadas reales: Gmail, GitHub, Ahrefs, Slack, paneles bancarios ya están iniciados sesión
• Relleno de formularios consciente de frameworks: safari_fill_and_submit llama a los setters de React/Vue/Angular de forma nativa, sin adivinar si los eventos input se dispararon
• Operación en segundo plano: el agente trabaja en paralelo mientras sigues usando tu Mac
• Una llamada MCP por flujo de trabajo: safari_run_script agrupa navegación + clics + extracción en un solo viaje de ida y vuelta

El patrón se mantiene en todos los modelos: maneja el navegador en el que el humano ya confía: heredas inicios de sesión, cookies, extensiones y el entorno exacto del usuario en un solo paso.

Comunidad

Más de 6,000 descargas mensuales de npm: los desarrolladores están construyendo agentes de IA en macOS con Safari MCP.

• Discusiones de GitHub: haz preguntas, comparte casos de uso
• Problemas: informes de errores y solicitudes de funciones
• : comienza a contribuir

Ecosistema

Otros servidores MCP para macOS que complementan Safari MCP:

¿Usas Safari MCP junto con Chrome DevTools MCP? Safari maneja el 95% de la navegación diaria (cero sobrecarga), Chrome maneja el 5% que necesita Lighthouse o trazas específicas de Chrome.

Listado en

Licencia

MIT: úsalo como quieras.

Creado por Achiya Automation — automatización y agentes de IA para empresas.