LinkLore

LinkLore

Servidor MCP para memoria de proyecto: permite que los agentes de IA registren decisiones, errores y especificaciones mientras trabajan, y las recuerden en la siguiente sesión con contexto de código adjunto.

Diseñado para agentes, no para humanos: cada herramienta aquí está pensada para ser utilizada por una IA, no para ser legible por una persona.

Por qué LinkLore

En cada nueva sesión, un agente de IA comienza desde cero: las decisiones se vuelven a discutir, los errores se redescubren, y el "¿por qué se hace así?" se responde adivinando. Las notas en Markdown no solucionan esto: están escritas para personas, se alejan del código, y ningún agente las lee de manera confiable.

LinkLore es memoria estructurada que el propio agente lee y escribe a través de herramientas MCP:

• Dos tipos de registros — lore (decisiones, errores, diario) y doc (especificaciones, planes), vinculados bidireccionalmente entre sí y con archivos de código.
• Local primero — todo vive en un almacén SQLite .linklore/ dentro de tu proyecto. No se necesita cuenta para empezar.
• Contexto de código — los registros se vinculan a archivos fuente; la detección de obsolescencia basada en git-diff señala memoria que el código ha superado.
• Recuperación económica — consulta por significado, etiqueta, archivo, estado o período; un brief() al inicio de sesión devuelve elementos abiertos y puntos críticos en unos pocos cientos de tokens.

Inicio rápido

Se ejecuta directamente desde PyPI — sin instalación ni clonación (uvx llre).

Claude Code

claude mcp add llre -- uvx llre

Cualquier otro cliente MCP (Cursor, Codex, Windsurf, …) — agrégalo a la configuración MCP del proyecto (por ejemplo, .mcp.json):

{
  "mcpServers": {
    "llre": {
      "command": "uvx",
      "args": ["llre"]
    }
  }
}

Luego inicializa, una vez, en la raíz del proyecto:

uvx llre init

O deja que tu agente haga todo — este es un servidor pensado para ser configurado por un agente de IA en lugar de ser escrito a mano. Pega esto como tu primer mensaje a Claude Code, Cursor, Codex o cualquier otro agente compatible con MCP:

Configura LinkLore (un servidor MCP para memoria de proyecto) en este repositorio. Es el paquete de PyPI llre, ejecutado mediante uvx llre — sin instalación ni clonación necesarias. Regístralo como servidor MCP para el cliente que seas (Claude Code: claude mcp add llre -- uvx llre; de lo contrario, agrega {"mcpServers": {"llre": {"command": "uvx", "args": ["llre"]}}} al .mcp.json de este proyecto), luego ejecuta uvx llre init aquí. Pregúntame primero antes de ejecutar uvx llre login — abre un navegador para iniciar sesión con Google y solo se necesita para respaldo personal o compartir en equipo.

El ciclo

Cómo lo usa realmente un agente, en orden:

start a session       →  brief()                  open items, recent activity, hotspots
about to touch code   →  show(file=..., query=…)  decisions & pitfalls tied to that area
decided / got burned  →  add(type='lore', …)      record it, linked to the files involved
spec or plan          →  add(type='doc', …)       instead of a standalone .md
something changed     →  edit(id=..., …)          append, replace a section, or supersede
memory getting messy  →  doctor() · cleanup()     integrity check, duplicate detection
back up / share       →  push() · openbox(…)      your server space · invite-only shared boxes

Herramientas disponibles

23 herramientas. Llama a cualquiera de ellas con help=True para ver el uso completo.

Categoría	Herramienta	Qué hace
Configuración	init	Configura .linklore/ en el directorio actual
Proyecto	brief	Panel de inicio de sesión — elementos abiertos, actividad reciente, puntos críticos
Proyecto	status	Detección de desincronización código↔doc (basada en git-diff)
Proyecto	config	Configuración del proyecto, fuentes externas, fijación de sesión
Diagnóstico	doctor	Verificación de integridad de datos; action='fix' repara automáticamente
Registro	add	Crea lore o doc; items=[{...}] crea en lote
Registro	edit	Modifica un elemento — añade (por defecto), reemplaza una sección, sobrescribe o sustituye
Registro	rm	Elimina — papelera recuperable por defecto, force=True para eliminación permanente
Registro	restore	Recupera de la papelera; sin id lista la papelera
Registro	local	Mueve/copia/ve elementos entre espacios de trabajo locales hermanos
Búsqueda	show	Consulta por id, texto, etiqueta, estado, archivo o período; vistas de grafo y etiquetas
Búsqueda	log	Historial de cambios
Enlace	link	Conecta dos elementos (lore↔lore, doc↔doc, doc↔lore)
Enlace	unlink	Desconecta dos elementos
Vista de doc	doc_flow	Renderiza la cadena de flujo de un doc en orden
Vista de doc	doc_map	Resumen de la red completa de enlaces de doc
Vista de doc	doc_rollup	Recopila lore vinculado a un doc en un borrador de resumen de IA
Limpieza	cleanup	Detecta candidatos de lore/doc casi duplicados
Mi servidor	push	Respalda el almacén local en tu propio espacio de servidor
Mi servidor	pull	Restaura desde tu propio espacio de servidor
Openbox	openbox	Todo el intercambio entre propietarios detrás de una sola puerta — push/pull, explorar, invitar/unirse, roles
Comentarios	report	Envía comentarios o un informe de error directamente al equipo

La guía completa se incluye dentro del producto, como lore — LinkLore se documenta a sí mismo. Después de init(), tu proyecto la lleva como fuente de solo lectura:

show(tag='guide')

Se actualiza con el paquete: actualiza llre y brief() te dice qué cambió.

Estructura del repositorio

• mcp/ — la parte legible del código fuente del servidor MCP (PyPI: llre)
• plugin/ — envoltorio del plugin de Claude Code

Modelo de código fuente

Mayormente legible, núcleo compilado. Este repositorio publica el código fuente del servidor MCP de forma clara — el punto de entrada, catálogos de i18n, utilidades base y la guía de incorporación — bajo la Licencia Elastic 2.0. Los módulos principales (búsqueda, clasificación, detección de contradicciones, la lógica de herramientas) se distribuyen como extensiones compiladas en la rueda publicada en lugar de código fuente en texto plano, por lo que "leer cada línea y bifurcarlo" no es 100% cierto — pero la mayoría es legible, y puedes ejecutarlo, autoalojarlo y usarlo comercialmente dentro de tu propia organización. Preferimos ser transparentes sobre que la lógica clave está compilada en lugar de pretender que es completamente abierto.

Este árbol no se puede compilar por sí solo (los módulos compilados no están aquí) — instala el paquete publicado en su lugar: uvx llre.

Investigación

LinkLore es el caso de estudio del artículo "When the Agent Is the User: Agent-Driven Evolution of AI-Native Tools" — que define la categoría AI-Native Tools, donde el agente de IA es el operador principal.

DOI: 10.5281/zenodo.21216858 · cita: CITATION.cff

Licencia

Licencia Elastic 2.0. Gratis para instalar y usar; no puedes proporcionar el software como un servicio gestionado competidor, eludir la funcionalidad de clave de licencia ni eliminar los avisos de licencia.

La sincronización de equipo, el intercambio entre proyectos y el respaldo en la nube son proporcionados por el servicio backend en linklore.io (no parte de este repositorio).