Arquitectura

Dos capas

el modelo de lenguaje, por su cliente MCP   juzga, decide, se lo explica a usted
   │   14 herramientas por la entrada y la salida estándar
mcp-server-diwall-browser                   observa, actúa, rechaza
   │   Chrome DevTools Protocol, solo en 127.0.0.1
su navegador, en su perfil dedicado         guarda sus sesiones iniciadas

junto al servidor
   el directorio cifrado                    credenciales de entrada; diario, capturas, descargas de salida
   la ventana de confirmación               kdialog o zenity, que usted responde

El modelo aporta el juicio. El servidor aporta lo que el modelo no puede tener por sí solo: la imagen y el árbol que usted vería, gestos en su sesión y rechazos que no dependen de lo que el modelo concluya.

Por qué el servidor trabaja en su navegador en lugar de iniciar uno se explica en Por qué el servidor se conecta a su navegador.

Una vuelta del bucle

1. open_tab o navigate carga una página en una pestaña que abrió el servidor. El servidor nunca lee ni maneja una pestaña que usted haya abierto.
2. observe toma una instantánea, numera los elementos sobre los que se puede actuar, dibuja las marcas y las máscaras en la imagen, y devuelve la imagen, el árbol, los elementos y un snapshot_id (Percepción).
3. El modelo nombra una marca de esa instantánea en click, fill, select_option o press_key.
4. El servidor cuenta la acción dentro de los topes, comprueba que el nodo que hay detrás de la marca es el observado y que la página está en un sitio de su perfil, y decide si la acción está bloqueada. Una acción bloqueada se escribe en el diario y se captura, y luego espera su respuesta; el servidor comprueba el nodo de nuevo, hace el gesto, espera la carga que ese gesto inició y captura otra vez.
5. El resultado sale por un único punto de salida, que retiene los valores sensibles y separa lo que afirma el servidor (server) de lo que escribió la página (page_content). El diario recibe una línea.

En el código

En la versión 0.0.1, el paquete tiene 22 módulos y un archivo por herramienta bajo tools/. Cada comprobación de seguridad vive en un solo módulo, y un módulo que la necesita llama a ese; las pruebas lo verifican, y también que ninguna herramienta evita el punto de salida. El documento de arquitectura del repositorio da el papel de cada uno de ellos.