Skip to content
FreddyB200Public

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

Roxy

Platanus Hack 26: Bogotá — Track: AI Security — team-3

Dashboard en vivo: https://roxygt.lat · SDK: https://pypi.org/project/roxy-guard/


Roxy

Gateway de seguridad para MCPs.

Un agente delega en otro, y ese en otro. El que termina escribiendo en la base está a varios saltos de quien pidió la tarea — y ejecuta con los mismos permisos que se autorizaron al entrar. Roxy se pone en el medio: carga las reglas del MCP, somete cada acción sensible a un verificador antes de que se ejecute, inyecta las credenciales solo si aprueba, y deja registrado cada intento.

pip install roxy-guard        # https://pypi.org/project/roxy-guard/
from roxy import Roxy

roxy = Roxy(api_url="https://roxygt.lat/api")
executor.invoke(entrada, config={"callbacks": [roxy]})   # el árbol se registra solo

Roxy viene de proxy

Un proxy se para en el medio y habla por vos. El agente no le habla al MCP: le habla a Roxy. Roxy evalúa, y si aprueba es Roxy quien hace la llamada, inyectando credenciales que el agente nunca ve (internal/gateway/mcpclient.go), y devolviéndole la respuesta cruda del MCP (internal/http/handlers.go).

Ahí está el punto: si Roxy solo respondiera «sí» o «no», el agente podría ignorarlo y llamar al MCP igual. No puede, porque sin pasar por Roxy no tiene credenciales con qué entrar. La decisión se cumple en vez de sugerirse.

El recorrido de una petición

agente ──▶ roxy-gateway ──▶ verificador ──▶ veredicto
                │                              │
                │◀─────────────────────────────┘
                ├── aprobado → llama al MCP con las credenciales
                └── denegado → 403, la acción nunca ocurre
                        │
                        └──▶ queda en el log, visible en el dashboard

La decisión no la toma un LLM. Un LLM traduce las reglas escritas en lenguaje natural a una política formal una sola vez; a partir de ahí el motor decide de forma determinista sobre esa política congelada, y Z3 la audita buscando huecos: ¿hay alguna acción destructiva que se cuele por las reglas escritas? Si la hay, devuelve el contraejemplo concreto. Cada veredicto se ancla además en Solana (devnet).

Bloques

# Bloque Carpeta Qué es
1 Datos mongo-data/ Esquema y datos de MCPs, reglas y logs de seguridad
2 Gateway roxy-gateway/ Go. Intercepta agente→MCP, consulta al verificador, ejecuta o corta
3 Dashboard dashboard/ FastAPI + React. Logs, árbol de agentes y la vista en vivo
4 API víctima demo-api/ La API de facturación que se corrompe si nadie vigila
5 Flujo de agentes agent-flow-demo/ LangChain. Orquestador y subagentes, con y sin Roxy
6 Investigación research/ Incidentes reales, mercado, competencia, arquitectura
8 Landing landing-page/ Página pública del producto
9 SDK roxy-sdk/ · PyPI roxy-guard: registra el árbol de delegación y somete acciones
10 Verificador verifier/ Rust + Z3 + atestación en Solana
— Infra infra/ Terraform: todo detrás de un CloudFront

Cada bloque es autónomo y se comunica con los demás por HTTP o por la base, nunca importando código de otro. Las reglas están en CLAUDE.md.

En producción

Todo corre en AWS, detrás de un solo CloudFront — un dominio, sin CORS entre piezas. Infraestructura como código en infra/ (Terraform).

ruta servicio
/ Dashboard (S3 + CloudFront)
/api/* API del dashboard — logs y árbol de agentes
/gateway/* Roxy Gateway
/demo-api/* La API víctima
/mcp* Servidor MCP
cd infra && ./scripts/deploy.sh

Verlo funcionando

curl https://roxygt.lat/demo-api/health/consistency   # el estado del dato
curl https://roxygt.lat/api/log?limit=20              # cada decisión de Roxy
curl https://roxygt.lat/gateway/health                # el gateway

El contraste completo, desde local contra el despliegue:

cd agent-flow-demo && ./compare.sh

Corre el mismo flujo dos veces, sin Roxy y con Roxy, y contrasta qué quedó escrito en cada caso.

Estado

Lo que corre en producción y lo que no está en research/ISSUES.md, con la evidencia de cada afirmación. Lo escribimos para nosotros, pero sirve igual para cualquiera que quiera verificar en vez de creernos.

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages