astrail
Plataforma open source que convierte especificaciones OpenAPI, GraphQL y servidores MCP existentes en herramientas tipadas para agentes IA. Incluye dashboard, CLI y clientes TypeScript/Python con gestión de credenciales, políticas de aprobación y trazas de ejecución.
Ficha actualizada 24 sept 2026, 12:40 · upstream 24 sept 2026, 12:07 · release sin release detectada
Qué es astrail
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Astrail transforma definiciones de API en herramientas tipadas descubribles por agentes a través del Protocolo de Contexto de Modelo (MCP). Permite importar especificaciones OpenAPI/Swagger, Google Discovery o GraphQL, generando esquemas de herramientas con mapeo determinista de endpoints. El runtime integra autenticación, OAuth, políticas de red y trazas en un único flujo de trabajo sin necesidad de evaluación dinámica del código generado.
La plataforma ofrece control granular sobre la ejecución mediante mapas de endpoints, verificación de credenciales y políticas de aprobación o bloqueo por herramienta. Incluye clientes para TypeScript y Python, SDKs exportables y una interfaz web para gestionar servidores y trazas. El despliegue soporta contenedores Docker y entornos locales sin base de datos para pruebas rápidas.
Los casos de uso abarcan desde soporte técnico (consulta de tickets con aprobación para cambios) hasta operaciones internas (búsqueda de inventario y creación de órdenes de compra). La arquitectura separa la generación estática de herramientas del runtime, permitiendo inspeccionar el flujo de solicitudes antes de ejecutarlas contra APIs upstream.
- Automatización de soporte técnico: consulta de tickets y preparación de actualizaciones con aprobación requerida para cambios críticos.
- Gestión de operaciones: lectura de inventario y creación de órdenes de compra con políticas de revisión por rol.
- Herramientas internas: búsqueda de registros CRM y actualización de campos con limitación de credenciales por función.
- Desarrollo de agentes IA: integración de APIs existentes en flujos de trabajo de agentes mediante MCP sin reescribir código backend.
- Generación determinista de herramientas tipadas a partir de especificaciones OpenAPI, GraphQL o servidores HTTP MCP existentes.
- Gestión integrada de autenticación OAuth y políticas de aprobación/bloqueo por herramienta individual.
- Trazas de ejecución completas para inspeccionar flujos de solicitud sin evaluar código generado dinámicamente.
- Soporte nativo para clientes TypeScript, Python y CLI con puente stdio para integración directa.
- Despliegue flexible vía Docker o entornos locales sin base de datos para validación rápida.
- La automatización web está limitada a flujos de lectura pública; no soporta escritura automática en sitios web.
- El modo Code Mode compila llamadas estáticamente y no puede ejecutar JavaScript arbitrario generado dinámicamente.
- Las aplicaciones OAuth y scopes requieren configuración manual del operador, sin integración automática con proveedores.
- La exportación a Workers Cloud tiene un conjunto de características más reducido que el runtime alojado.
- Los despliegues multi-región necesitan límites distribuidos externos y protección de borde adicional no incluida por defecto.
Capturas del proyecto
Imágenes reales detectadas en la documentación del repositorio.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Requiere Node.js 22.18+. Para desarrollo local, usa `npm run dev` en puerto 3000. Para producción, sigue la guía Docker o configura Neon para backend persistente. Exporta credenciales vía variables de entorno y utiliza el CLI para gestionar herramientas y trazas. No se recomienda exponer endpoints sin autenticación adecuada; consulta el modelo de amenazas antes de desplegar en entornos críticos.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.