Ctrl K
ComunidadGuías…
GITHUB · ANALIZADO

nacre

Capa de contexto autoalojada para agentes con control de acceso granular. Nacre actúa como índice de conocimiento subyacente, permitiendo a los agentes acceder solo a documentos autorizados mediante MCP y API REST.

Ficha actualizada 25 sept 2026, 19:03 · upstream 25 sept 2026, 18:45 · release v0.26.1

00

Qué es nacre

Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.

Nacre es una capa de contexto autoalojada para agentes con control de acceso granular. Actúa como índice de conocimiento subyacente sin interfaz de chat ni asistente corporativo. Los agentes acceden vía MCP, aplicaciones vía API REST.

El sistema aplica filtros de acceso durante la travesía HNSW del índice, no después del ranking, garantizando que top_k devuelva k resultados permitidos. Soporta búsqueda híbrida (vectores densos + BM25) con fusión de rango recíproco y reranking configurable.

La arquitectura incluye: API REST y servicio de autorización, servidor MCP (HTTP streamable + STDIO), pipeline de indexación, modelo de datos con resolutivo de permisos, SDK TypeScript e interfaz admin. Usa PostgreSQL, Redis y S3/MinIO como servicios.

CASOS DE USO
  • Índice de conocimiento corporativo para agentes IA con control de acceso por usuario
  • Capa de contexto para herramientas MCP que requieren filtrado de documentos sensible
  • Almacenamiento de embeddings con múltiples modelos compatibles (OpenAI-compatible)
  • Sistema de auditoría para compliance con logs de acceso granulares
PUNTOS DESTACADOS
  • Filtrado de permisos durante HNSW traversal, no post-filtro
  • MCP como superficie first-class con HTTP streamable y STDIO
  • Búsqueda híbrida: vectores densos + BM25 + reranking configurable
  • Auditoría completa con GET /v1/audit (JSONL, CSV, JSON)
  • Sin phone-home, todo Docker Compose local
  • Apache 2.0 completo sin componentes propietarios
PRECAUCIONES
  • Estado temprano: documentación por delante del código en algunas áreas
  • Multi-tenancy, SSO/SCIM y document-level deny rules son módulos comerciales
  • No incluye HA Helm charts ni backup automático
  • Complejidad HIGH: requiere 4 cores CPU, 8GB RAM, 30GB disco mínimo
  • Sin soporte one-click deployment
01

Perfil de infraestructura

Estimación inicial derivada del repositorio y de los servicios detectados.

CPU4 vCPUrecomendación inicial
MEMORIA8 GBRAM estimada
DISCO30 GBalmacenamiento base
COMPLEJIDADhighnivel de operación
02

Despliegue detectado

Qué señales reales de instalación hemos encontrado.

Docker Compose detectado

Usar docker compose --profile minimal up -d. Requiere PostgreSQL y Redis externos o incluir en compose. Para Apple Silicon, leer docs/apple-silicon.md primero (embedder corre en host). Portos: 80, 6333, 8080-8082, 8090-8091, 9000. Inicializar con npx @nacre.work/cli o curl directo. Verificar docs/authz.md antes de producción.

✓Dockerfile
✓Compose
—One-click
03

Stack y dependencias

Componentes inferidos a partir de manifests, configuración y documentación.

FRAMEWORKS
Node.jsPython
SERVICIOS
PostgreSQLRedisS3/MinIO
BASES DE DATOS
PostgreSQLRedis
PUERTOS
808280808081806333809080919000
05

Puede sustituir a

Relaciones detectadas por el análisis del repositorio y su categoría.

06

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.