sncro-relay

Componentes de código abierto de sncro: el relé MCP, el agente del lado del navegador y los complementos de framework que permiten a los asistentes de programación de IA inspeccionar un navegador en vivo.

Qué contiene este repositorio

Cómo funciona

 ┌──────────────┐    MCP     ┌──────────┐   long-poll   ┌─────────────┐
 │ Claude Code  │──tools────▶│  relay   │◀──────────────│  agent.js   │
 │ (or other    │            │ (relay/) │   snapshots   │ (injected   │
 │  MCP client) │◀──results──│          │──────────────▶│  by plugin) │
 └──────────────┘            └──────────┘               └─────────────┘
                                                              ▲
                                                              │ same-origin
                                                              │ cookies
                                                       ┌─────────────┐
                                                       │  your app   │
                                                       │ (plugin is  │
                                                       │  installed) │
                                                       └─────────────┘

1. Claude llama a create_session (herramienta MCP) → el relé devuelve una clave de sesión de 9 dígitos + URL

2. El usuario visita la URL en el navegador donde se ejecuta su aplicación → confirma mediante "¿Permitir depuración de sncro?"

3. El complemento coloca una cookie, agent.js se inyecta en las respuestas HTML posteriores en ese origen

4. agent.js envía datos de referencia (consola, errores) y realiza sondeos largos para consultas bajo demanda (query_element, get_page_snapshot, etc.)

Uso de sncro

La mayoría de los usuarios no necesitan ejecutar el relé por sí mismos; la versión alojada en relay.sncro.net es compatible con el nivel gratuito. Registre su proyecto en sncro.net y obtenga su clave de proyecto.

FastAPI: coloque middleware/sncro_middleware.py en su proyecto, luego:

from middleware.sncro_middleware import SncroMiddleware, sncro_routes

app = FastAPI(debug=True)  # sncro only loads when debug=True
if app.debug:
    app.include_router(sncro_routes)
    app.add_middleware(SncroMiddleware, relay_url="https://relay.sncro.net")

Flask: coloque middleware/sncro_flask.py en su proyecto, luego:

from sncro_flask import init_sncro

app = Flask(__name__)
if app.debug:
    init_sncro(app, relay_url="https://relay.sncro.net")

Ambos middlewares solo se activan en modo de depuración: cero sobrecarga en producción.

Contribución

Nos encantan los nuevos complementos de framework. CONTRIBUTING.md tiene la especificación completa de lo que debe hacer un complemento (cookies, rutas, encabezados de seguridad) además de la plantilla de prueba. Django, Rails, Express, Next.js, ASP.NET, Go: todos son bienvenidos.

Informes de errores y problemas de seguridad: consulte SECURITY.md.

Licencia

MIT. Consulte LICENSE.

El panel de control en sncro.net (gestión de proyectos, facturación, administración) reside en un repositorio propietario separado.