Skip to main content
Glama
AliYar-Khan

light-agent-memory-mcp-server

by AliYar-Khan

light-agent-memory-mcp-server

Servidor MCP para memoria persistente de agentes: proyectos, preferencias y aprendizajes de sesión almacenados en una base de datos SQLite local.

Independiente del harness. Funciona con cualquier cliente compatible con MCP: opencode, Claude Desktop, Cursor, Windsurf, etc.

Instalación

npm install -g light-agent-memory-mcp-server

O úsalo directamente con npx (no requiere instalación):

npx light-agent-memory-mcp-server

Related MCP server: tartarus-mcp

Configuración

Añádelo a la configuración de tu cliente MCP:

opencode (~/.config/opencode/opencode.json):

{
  "mcp": {
    "memory": {
      "type": "local",
      "command": ["npx", "-y", "light-agent-memory-mcp-server"],
      "enabled": true
    }
  }
}

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": ["-y", "light-agent-memory-mcp-server"]
    }
  }
}

Cursor (.cursor/mcp.json):

{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": ["-y", "light-agent-memory-mcp-server"]
    }
  }
}

Ruta personalizada de la base de datos

npx light-agent-memory-mcp-server --db /path/to/custom.db

Herramientas

Memoria de proyectos

Herramienta

Descripción

memory_project_save

Guardar o actualizar el contexto del proyecto (stack tecnológico, arquitectura, convenciones)

memory_project_get

Obtener los detalles de un proyecto por nombre

memory_project_list

Listar todos los proyectos guardados

Memoria de preferencias

Herramienta

Descripción

memory_pref_save

Guardar o actualizar una preferencia personal de programación

memory_pref_get

Obtener una preferencia por clave

memory_pref_list

Listar preferencias (opcionalmente filtradas por categoría)

Memoria de aprendizajes

Herramienta

Descripción

memory_learning_save

Registrar un aprendizaje de la sesión (solución, idea clave, nota de error)

memory_learning_search

Buscar aprendizajes por palabra clave

Genéricas

Herramienta

Descripción

memory_save

Guardado unificado (enruta automáticamente por tipo)

memory_search

Búsqueda entre tipos por palabra clave

memory_delete

Eliminar una memoria por tipo e ID

memory_list

Listar todas las memorias con paginación y estadísticas

Ejemplos

Guardar un proyecto:

memory_project_save({
  name: "my-app",
  path: "/home/user/projects/my-app",
  tech_stack: ["TypeScript", "React", "SQLite"],
  architecture: "Monorepo with pnpm workspaces, plugin-based architecture",
  conventions: "ESM-only, strict TypeScript, no comments in code"
})

Guardar una preferencia:

memory_pref_save({
  key: "language.typescript.style",
  value: "Always use ESM imports, strict mode, and prefer readonly types",
  category: "language"
})

Registrar un aprendizaje:

memory_learning_save({
  title: "Fix SQLite WAL mode deadlock",
  content: "When using WAL mode in SQLite, set busy_timeout to 5000ms to avoid SQLITE_BUSY errors under concurrent reads.",
  project_name: "my-app",
  tags: ["sqlite", "debugging", "concurrency"]
})

Buscar en todas las memorias:

memory_search({ query: "SQLite" })

Base de datos

Los datos se almacenan en ~/.agent-memory/memory.db de forma predeterminada (SQLite mediante el módulo integrado node:sqlite de Node.js). La base de datos se crea automáticamente en el primer arranque.

Esquema

  • projectsid, name (único), path, tech_stack (JSON), architecture, conventions, notes, marcas de tiempo

  • preferencesid, key (única), value, category, marcas de tiempo

  • learningsid, title, content, project_name, tags (JSON), marcas de tiempo

Desarrollo

git clone https://github.com/AliYar-Khan/light-agent-memory-mcp-server.git
cd light-agent-memory-mcp-server
npm install
npm run build
npm run dev  # runs with tsx, no build step

Licencia

MIT

A
license - permissive license
A
quality
B
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    Not graded
    quality
    C
    maintenance
    Provides persistent, local-first AI memory across sessions via MCP tools for storing, searching, and retrieving context from past interactions.
    1
    MIT
  • A
    license
    Not graded
    quality
    C
    maintenance
    A local-first MCP memory server providing persistent, searchable memory for AI agents, powered by SQLite.
    5
    1
    Apache 2.0
  • A
    license
    Not graded
    quality
    A
    maintenance
    Provides persistent memory for AI coding agents via MCP, enabling agents to store and semantically recall facts, events, and lessons across sessions, all running locally without cloud dependencies.
    Apache 2.0
  • A
    license
    Not graded
    quality
    C
    maintenance
    Persistent memory for AI coding agents. Enables agents to save and recall decisions, patterns, bugs, and context across sessions via an MCP server with local SQLite storage.
    45
    2
    MIT

View all related MCP servers

Related MCP Connectors

  • Shared, governed long-term memory for AI agents across tools and sessions via MCP and REST.

  • Persistent memory for AI agents. Search, store, and recall across sessions.

  • Your memory, everywhere AI goes. Build knowledge once, access it via MCP anywhere.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/AliYar-Khan/light-agent-memory-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server