openchronicle-mcp
Base de datos de memoria para agentes LLM con persistencia semántica y por palabras clave, nombrespacing por proyecto, onboarding desde git y acceso vía HTTP REST y MCP en un solo proceso ASGI. Base de datos SQLite, contenedorizable.
Ficha actualizada 23 sept 2026, 7:00 · upstream 23 sept 2026, 6:59 · release v3.3.0
Qué es openchronicle-mcp
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
OpenChronicle es una base de datos de memoria persistente para agentes de IA generativa. Permite guardar decisiones, hitos y enfoques rechazados que sobreviven a la compresión del contexto y nuevas conversaciones. Se recupera mediante búsqueda híbrida (full-text y semántica) usando Reciprocal Rank Fusion.
Características principales: - Persistencia de memoria entre sesiones sin necesidad de reingresar al repositorio. - Namespacing por proyecto: la información se escapa del contexto global, evitando contaminación entre workstreams distintos. - Git onboarding: el repositorio se clona y los commits relacionados se agrupan para generar resúmenes que sirven como semilla inicial para la memoria a largo plazo. - Un solo proceso ASGI aloja tanto la superficie REST (`/api/v1/*`) como el transport MCP (`/mcp`), con un único puerto, una sola configuración de salud y un único punto de fallo. - Degradación elegante ante fallos del proveedor de embeddings: cuando el servicio falla, la búsqueda cae a FTS5 puro y se muestra el estado degradado mediante `/api/v1/health` y el tool MCP `health`. El backfill recupera los datos cuando el proveedor vuelve en línea. La endpoint `/health` permanece como prober minimalista. - Opcional: registro de métricas operativas (Prometheus) y endpoint `/metrics`, disponibles en builds de desarrollo pero no incluidos por defecto en la imagen v3.3.0. Se puede activar con `OC_METRICS_ENABLED=true` según lo documentado. - Framework de migraciones de esquema: versiones de `.sql` con atomicidad mediante savepoints. Las actualizaciones futuras se añaden como archivos `NNN_<slug>.sql`. La migración es idempotente. - Backups atomicos en línea: utiliza la API de backup de SQLite, ejecutando primero un vacuum como parte del mismo job para garantizar integridad antes de cualquier operación destructiva.
No es una engine de conversión. No contiene LLMs. Se conecta a agentes externos (Claude Code, Goose, Open WebUI, etc.) mediante el servidor MCP.
No es multi-tenant: es un solo usuario. La autenticación con token Bearer (`OC_API_KEY`) está soportada pero opcional y deshabilitada por defecto para entornos LAN confiables. Ver `docs/configuration/security_postur
- Guardar decisiones y hitos clave de un agente LLM para persistirlos entre sesiones o tras nuevas conversaciones.
- Persistencia semántica y por palabras clave con búsqueda híbrida (Reciprocal Rank Fusion) que combina ambos enfoques.
- Namespacing por proyecto evita que el contexto de un trabajo se propague innecesariamente a otros workstreams.
- No es una engine de conversión: no contiene LLMs ni modelos de generación. Se conecta a agentes externos como Claude Code, Goose o Open WebUI mediante el servidor MCP.
- No es multi-tenant: es un solo usuario. La autenticación Bearer está opcional y deshabilitada por defecto en entornos LAN confiables.
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.
Instalación desde source: `pip install -e ".[mcp,openai]"` seguido de `oc init` y `oc serve`. El puerto predeterminado es 8000. En contenedor Docker se requiere `OC_API_HOST=0.0.0.0` para que el host externo pueda conectarse (el app default binda al loopback). Para NAS, usar `docker-compose.nas.yml`. La imagen v3.3.0 no incluye métricas por defecto; activar con `OC_METRICS_ENABLED=true` en builds de desarrollo.
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.