Memory Kernel MCP server

Memory Kernel

<!-- mcp-name: io.github.Artem362/memory-kernel -->

Memory Kernel is a small local memory layer for AI agents.

It helps you save useful things such as decisions, constraints, tasks, facts, and notes in a local SQLite database, then pull back only the few memories that matter for the current task.

Published package name on PyPI: amormorri-memory-kernel CLI command after install: memory-kernel

Practical guide in Ukrainian: docs/OPERATINGGUIDEUK.md

Release notes: CHANGELOG.md

Contents

• What It Does
• Start In 5 Minutes
• Typical Workflow
• Which Command To Use
• Write: remember, ingest
• Read: search, context, wake-up, stats
• Inspect / edit: list, show, update, delete
• Lifecycle: forget / restore, revise, decay
• Maintain: completion, verify
• Backup: export, import
• Use With An LLM (MCP)
• How It Works

What It Does

In plain English, Memory Kernel does 4 things:

1. Stores memory locally on your machine.
2. Keeps memory structured enough to stay useful.
3. Finds relevant records without a heavy vector stack.
4. Builds a small context pack instead of dumping everything into the prompt.

This project is not trying to create a magical black-box memory. It is trying to create a memory layer you can inspect, control, export, and trust.

Start In 5 Minutes

If you just want to try it, do this:

pip install amormorri-memory-kernel
memory-kernel init
memory-kernel remember --scope my.project --kind decision --title "Keep memory local" --content "We store memory on the user's machine."
memory-kernel search "memory local"
memory-kernel export --format json --output exports\memory.json

What happened there:

1. init created a local database.
2. remember saved one clear memory.
3. search fetched it back.
4. export created a backup file you can move or restore later.

If you are using the repository instead of PyPI:

pip install -e .[dev]

Typical Workflow

Most people will use it like this:

1. Save one precise memory with remember.
2. Feed raw notes or transcripts with ingest.
3. Before an agent run, fetch only what matters with search, context, or wake-up.
4. Inspect, fix, or remove single records with show, update, or delete.
5. Periodically export the database for backup.
6. Restore it elsewhere with import.

Which Command To Use

remember

Use remember when you already know exactly what should be saved.

Good examples:

• a decision
• a rule
• a user preference
• a project constraint

memory-kernel remember --scope project.alpha --kind decision --title "Use SQLite FTS5" --content "We use SQLite FTS5 for local retrieval."

ingest

Use ingest when you have raw text and want the system to split it into structured memories.

Good examples:

• meeting notes
• a transcript
• a rough planning document
• an agent session log

memory-kernel ingest --scope project.alpha --file notes.txt --source sprint-review --tags planning transcript

Shortened. The full README is on GitHub.