Stellara

Stellara es una puerta de enlace de herramientas de IA autohospedada para Firecrawl, Exa, Qdrant y un backend de embeddings. Expone una única interfaz HTTP y de Model Context Protocol (MCP), protegida por token, para clientes de LLM como Claude Desktop y conectores de ChatGPT.

La puerta de enlace centraliza las credenciales de los servicios externos, la autenticación, los límites de velocidad, la validación de respuestas y las salvaguardas de red. También proporciona sesiones de navegador de Playwright, memoria vectorial por usuario y comprobaciones de disponibilidad de dominios.

Capacidades

• web_* — buscar, hacer scraping, rastrear, extraer y realizar solicitudes HTTP o GraphQL protegidas.

• browser_* — ejecutar sesiones interactivas de Playwright para navegación, formularios, capturas de pantalla, PDFs y evaluación de JavaScript.

• memory_* — almacenar y recuperar contexto por usuario mediante embeddings y Qdrant.

• domain_availability — comprobar el registro de dominios mediante RDAP con un respaldo de WHOIS.

• OAuth 2.1 y MCP — conectar clientes basados en token o clientes MCP compatibles con OAuth a través de una única puerta de enlace.

Consulta la referencia de herramientas para ver el catálogo completo.

Related MCP server: webcrawl-mcp

Requisitos

• Node.js 24 o superior

• pnpm 10.33.4 mediante Corepack

• Credenciales de proveedor para las funciones que habilites

• Docker para el despliegue en contenedor

Desarrollo local

corepack enable
pnpm install
cp .env.example .env

Configura una URL base pública, al menos un STELLARA_TOKEN_<USERID> y los valores de Firecrawl necesarios en .env. Las credenciales opcionales de Exa, Qdrant y embeddings habilitan sus familias de herramientas correspondientes.

Inicia el servidor de desarrollo:

pnpm dev

El endpoint de salud está disponible en http://localhost:8787/health salvo que se modifique PORT.

Despliegue en contenedor

La imagen de contenedor compatible es ghcr.io/sebastian-software/stellara. Los lanzamientos versionados publican una etiqueta de parche estable, además de la etiqueta de versión menor móvil y la etiqueta latest.

Copia .env.example a .env, configura la red de proxy externa, prepara stellara-data/ para el UID/GID 999 y luego inicia el servicio:

docker compose up -d

Lee la guía de operaciones antes de exponer el servicio. Cubre la confianza del proxy, la persistencia de OAuth, las copias de seguridad y la recuperación.

Desarrollo y pruebas

El control de calidad local requerido es:

pnpm agent:check

Este comando ejecuta la comprobación de tipos, el linting, la verificación del formato y la suite de pruebas unitarias hermética. Las pruebas en vivo con proveedores son opcionales, solo locales y requieren credenciales proporcionadas a través de las variables de entorno habituales:

pnpm test:integration

GitHub Actions nunca recibe ni ejecuta estas credenciales de integración.

Documentación

• Guía de usuario

• Referencia de herramientas

• Guía de desarrollo

• API de herramientas

• Estrategia de pruebas

• Arquitectura

• Operaciones

• Proceso de lanzamiento

Parte de la documentación detallada está actualmente disponible en alemán. El trabajo de traducción se registra en el rastreador de incidencias público.

Contribuciones y soporte

Lee CONTRIBUTING.md antes de abrir una pull request. Usa GitHub Issues para errores reproducibles y propuestas de funcionalidad concretas. Consulta SUPPORT.md para conocer la política de soporte del proyecto.

Notifica las vulnerabilidades de seguridad de forma privada como se describe en SECURITY.md. No reveles vulnerabilidades en incidencias públicas.

Licencia

Stellara está disponible bajo la Licencia MIT.