GDD (Giggly-Dazzling-Duckling)

GDD — Giggly-Dazzling-Duckling

Granja de navegadores controlada por IA en tu máquina
Simula múltiples usuarios reales en 22 tipos de dispositivos: prueba tu sitio como si fuera el día del lanzamiento.

Cómo funciona

Tú: Abre 3 iPhones y un escritorio, navega a myapp.com, prueba el formulario de registro en todos los dispositivos

Claude Code crea 4 navegadores con emulación de dispositivos, navega cada uno a tu aplicación, completa el formulario, toma capturas de pantalla y revisa la consola en busca de errores, todo en paralelo.

gdd_add_players(3, device="iPhone 15 Pro")    → players [1, 2, 3]
gdd_add_players(1, device="Desktop 1080p")    → player  [4]
gdd_navigate(1, "https://myapp.com")          → all 4 browsers open your app
gdd_tap(1, "#signup-btn")                     → taps signup on iPhone
gdd_screenshot(1)                             → captures the result
gdd_get_console(1, level="error")             → checks for JS errors

GDD ejecuta N instancias aisladas de Chromium, cada una con su propio perfil, cookies, emulación de dispositivo, geolocalización y condiciones de red. Expone 39 herramientas MCP a través de HTTP en localhost:9700.

Instalación

GDD viene en dos versiones. El Servidor es headless: es solo el backend MCP, se ejecuta en cualquier lugar (incluidas máquinas sin pantalla) y es todo lo que necesitas para automatización pura con IA. La aplicación de escritorio añade una GUI: una cuadrícula en vivo de miniaturas de navegadores en las que puedes hacer clic para tomar el control de una sesión manualmente. El Servidor se ejecuta en el puerto 9700, la aplicación de escritorio en 9800 — para que puedas ejecutar ambos en paralelo.

Servidor (headless) — el backend MCP:

Aplicación de escritorio (GUI) — una cuadrícula en vivo de miniaturas de navegadores en las que puedes hacer clic:

La aplicación de Windows usa WebView2; la aplicación de Linux/macOS (creada con Avalonia) controla ventanas reales de Chromium mantenidas fuera de pantalla. Binario autocontenido, ~70 MB. No se necesita instalación de .NET. Chromium se descarga automáticamente en el primer inicio.

Una línea (Linux):

curl -sL https://github.com/Cap-of-tea/GDD/releases/latest/download/GDD-Server-Linux.tar.gz | tar xz && chmod +x GDD.Headless && ./GDD.Headless

# Run (headless, port 9700)
docker run -p 9700:9700 ghcr.io/cap-of-tea/gdd

# Or build locally
docker build -t gdd .
docker run -p 9700:9700 gdd

Por defecto, los navegadores se lanzan en modo headed (ventanas visibles). Añade --headless para CI/CD. Otras banderas: --stealth y --stealth-max para enmascaramiento anti-bot, --update para autoactualización, --version y --help. La sección Configuración a continuación enumera todas las banderas y variables de entorno.

Conéctate a tu cliente de IA

Añade a .mcp.json y reinicia tu cliente de IA:

{
  "mcpServers": {
    "gdd": {
      "url": "http://localhost:9700/mcp"
    }
  }
}

Eso es todo. Inicia GDD, dile a Claude o Cursor que pruebe tu aplicación.

Usuarios de Claude Desktop: Descarga el archivo .mcpb desde Releases y ábrelo: GDD se instala como una extensión de escritorio con un clic. No se necesita configuración manual.

{
  "servers": {
    "gdd": {
      "type": "http",
      "url": "http://localhost:9700/mcp"
    }
  }
}

{
  "mcp": {
    "servers": {
      "gdd": {
        "type": "http",
        "url": "http://localhost:9700/mcp"
      }
    }
  }
}

{
  "servers": {
    "gdd": {
      "type": "stdio",
      "command": "bash",
      "args": ["/absolute/path/to/Scripts/mcp-proxy.sh"]
    }
  }
}

{
  "permissions": {
    "allow": [
      "mcp__gdd__*"
    ]
  }
}

{
  "mcpServers": {
    "gdd": {
      "command": "powershell",
      "args": ["-ExecutionPolicy", "Bypass", "-File", "C:/path/to/Scripts/mcp-proxy.ps1"]
    }
  }
}

{
  "mcpServers": {
    "gdd": {
      "command": "bash",
      "args": ["/path/to/Scripts/mcp-proxy.sh"]
    }
  }
}

bash Scripts/install-launchd.sh            # headed (default)
bash Scripts/install-launchd.sh --headless  # for CI/CD

mkdir -p ~/.config/systemd/user
cat > ~/.config/systemd/user/gdd.service << 'EOF'
[Unit]
Description=GDD Multi-Browser Testing Server
[Service]
ExecStart=/path/to/GDD.Headless
WorkingDirectory=/path/to/gdd-directory
Restart=on-failure
[Install]
WantedBy=default.target
EOF

systemctl --user daemon-reload
systemctl --user enable --now gdd

curl -X POST http://localhost:9700/mcp -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"gdd_add_players","arguments":{"count":1}}}'

Características

• Multi-dispositivo — Ejecuta N instancias aisladas de Chromium con 22 ajustes predefinidos de dispositivos (teléfonos, tabletas, escritorios)
• Nativo para IA — 39 herramientas MCP para Claude Code, Cursor o cualquier cliente compatible con MCP
• Multiplataforma — GUI nativa con un muro de video en vivo en Windows, Linux y macOS, además de un servidor headless para CI/CD
• Interacción completa — Navegar, tocar, escribir, presionar teclas y atajos, arrastrar, deslizar, desplazarse, pasar el cursor, manejar diálogos, tomar capturas de pantalla
• Teclado real — Escribir envía pulsaciones de teclas genuinas y confiables (la cadena completa keydown→input), por lo que las máscaras de entrada, el autocompletado y maxlength se comportan exactamente como para un usuario real, y los editores de texto enriquecido (contenteditable) funcionan; gdd_press maneja teclas individuales y atajos como Enter, Tab, Escape y Ctrl+A
• Diseños de teclado físicos — Las pulsaciones llevan el code/keyCode real del teclado de la configuración regional emulada: el ruso ЙЦУКЕН coloca «а» en el KeyF físico, el francés AZERTY y el alemán QWERTZ reasignan sus teclas, los acentos de teclas muertas y los símbolos AltGr funcionan. El diseño sigue gdd_set_language automáticamente (US, RU, DE, FR)
• Entrada similar a la humana — humanize=true impulsa una trayectoria de cursor continua (Bézier cúbico con easing y micro-vibración) que se mantiene entre clics, desplazamientos y arrastres; los toques envían una única entrada apropiada para el dispositivo (táctil o mouse), nunca ambas
• Sigilo anti-bot — --stealth opcional enmascara las señales habituales de automatización (navigator.webdriver, etc.); --stealth-max añade evasiones de headless/datacenter (user-agent coherente con client hints, un proveedor WebGL plausible, métricas de dispositivo realistas) — en un contenedor headless esto redujo a la mitad la puntuación headless de CreepJS
• Soporte de proxy — Enruta cada navegador a través de un proxy ascendente con GDD_PROXY (con autenticación opcional)
• Reescritura de encabezados — gdd_set_headers puede eliminar X-Frame-Options/CSP frame-ancestors para cargar un sitio en un iframe, o agregar/reemplazar encabezados de respuesta
• Emulación de dispositivos — Tamaño de pantalla, DPR, táctil, user-agent, geolocalización, zona horaria, idioma
• Control de red — Simula 4G, Fast 3G, Slow 3G o sin conexión por navegador
• Diagnósticos — Errores de consola, tráfico de red, métricas de rendimiento, notificaciones push
• Baliza de errores — Cada respuesta de herramienta advierte sobre errores de JS en todos los navegadores automáticamente
• Listo para Docker — Imagen oficial en GHCR (ghcr.io/cap-of-tea/gdd), listada en el MCP Registry
• Autoactualizable — Verificación de versión integrada y actualización con un comando

Herramientas MCP (39)

Gestión de jugadores

Navegación

Interacción

Lectura y capturas de pantalla

Emulación

Estado y diagnósticos

Autenticación y Ejecución

Almacenamiento del Navegador

Ayuda y Actualizaciones

Arquitectura

Client (AI agent / curl / script)
         │ POST /mcp (JSON-RPC 2.0)
         ▼
    McpServer (:9700)
    Streamable HTTP + SSE
         │
         ▼
    McpToolRegistry (39 tools)
    Player · Navigation · Interaction · Read
    Emulation · Auth · State · Diagnostics
         │
         ▼
    IPlayerManager
    MainViewModel (WPF) / DesktopPlayerManager (Avalonia) / HeadlessPlayerManager
         │
         ▼
    IBrowserEngine Instances
    WebView2 (Win GUI)  |  Playwright (Desktop GUI + headed/headless server)
    Each: own profile, CDP session, emulation

Ediciones

GDD se distribuye como tres aplicaciones sobre un núcleo compartido. Las dos GUI difieren solo en el kit de herramientas de escritorio (WebView2 en Windows, Avalonia en Linux/macOS); las tres exponen las mismas 39 herramientas MCP.

Stack Tecnológico

BrowserXn.sln
├── src/
│   ├── GDD.Core/              ← Shared library (net8.0)
│   │   ├── Abstractions/      ← IBrowserEngine, IPlayerManager, ...
│   │   ├── Mcp/               ← MCP server, tools, protocol
│   │   ├── Models/            ← Device, Location, Network presets
│   │   ├── Services/          ← CDP, Emulation, Monitoring services
│   │   └── Collections/       ← RingBuffer
│   ├── BrowserXn/             ← Windows GUI (WPF + WebView2)
│   │   ├── Engines/           ← WebView2ControlAdapter
│   │   ├── ViewModels/        ← MVVM (MainViewModel : IPlayerManager)
│   │   ├── Views/             ← XAML + VideoWallPanel
│   │   └── ...
│   ├── GDD.Desktop/           ← Linux/macOS GUI (Avalonia + Playwright)
│   │   ├── Engines/           ← PlaywrightHeadedEngine (headed, parked off-screen)
│   │   ├── ViewModels/        ← MainViewModel (DesktopPlayerManager)
│   │   ├── Views/             ← AXAML + VideoWallPanel
│   │   └── Scripts/           ← mcp-proxy.sh, setup-macos.sh, install-deps.sh
│   └── GDD.Headless/          ← Cross-platform server (Playwright)
│       ├── Engines/           ← PlaywrightEngine
│       ├── Platform/          ← HeadlessPlayerManager
│       └── Scripts/           ← mcp-proxy.sh, mcp-proxy.ps1
└── .github/workflows/         ← CI/CD (8 build targets + auto-release)

{
  "GDD": {
    "FrontendUrl": "about:blank",
    "BackendUrl": "http://localhost:8080/api/v1",
    "BotToken": "",
    "McpPort": 9700,
    "DataFolderRoot": "",
    "Stealth": false
  }
}

# Windows GUI (requires Windows 10/11 + WebView2)
dotnet publish src/BrowserXn/BrowserXn.csproj -c Release -p:PublishSingleFile=true -o ./publish/win-gui

# Cross-platform headless
dotnet publish src/GDD.Headless/GDD.Headless.csproj -c Release -r linux-x64 --self-contained -o ./publish/linux-x64
dotnet publish src/GDD.Headless/GDD.Headless.csproj -c Release -r osx-arm64 --self-contained -o ./publish/osx-arm64
dotnet publish src/GDD.Headless/GDD.Headless.csproj -c Release -r win-x64 --self-contained -o ./publish/win-x64

Documentación

• GDD-MANUAL.md — Manual de uso completo con ejemplos de flujo de trabajo
• GDD-ARCHITECTURE.md — Análisis profundo de la arquitectura
• GDD-PROMPT.md — Instrucciones del agente Claude para la integración MCP
• DEPLOY-RAILWAY.md — Aloja GDD como servidor MCP remoto en Railway (detrás de un proxy de autenticación por token)
• CONTRIBUTING.md — Directrices de contribución

Privacidad

Licencia

imVS©, gratuito para uso personal.

Código fuente disponible — No comercial. Gratuito para uso personal, educativo e investigación. El uso comercial requiere una licencia de pago. Consulta LICENSE para los términos completos.

Licencias comerciales: 2vsmirnov@gmail.com