English Français العربية

io.github.kurovu146/memory-fts

Registre officiel Outils de développement

Long-term memory for Claude Code with SQLite FTS5 search and BM25 ranking

Code source Documentation

Que pouvez-vous faire avec io.github.kurovu146/memory-fts ?

  • Hybrid search — FTS5 keyword search + semantic vector similarity, merged via Reciprocal Rank Fusion (RRF)
  • Semantic understanding — find memories by meaning, not just keywords (powered by all-MiniLM-L6-v2 embeddings)
  • Auto context injection — top 30 most important memories injected into every prompt via hook
  • Importance ranking — facts ranked by access frequency, recency decay, and category weight
  • Access tracking — tracks how often each memory is accessed
  • Upsert — automatically updates existing facts instead of duplicating
  • Categorized — organize by type: preference, decision, technical, project, workflow, personal, general
  • MCP Resources — exposes memory://context resource for session context

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

NPM package claude-memory-fts
Claude Code 
claude mcp add memory-fts -e 'MEMORY_DB_PATH=<MEMORY_DB_PATH>' -- npx -y claude-memory-fts@1.0.1
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "memory-fts": {
            "command": "npx",
            "args": [
                "-y",
                "claude-memory-fts@1.0.1"
            ],
            "env": {
                "MEMORY_DB_PATH": "<MEMORY_DB_PATH>"
            }
        }
    }
}

Variables d'environnement

  • MEMORY_DB_PATH Custom path to the SQLite database file (default: ~/.claude/memory.db)

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. claude-memory-fts
  2. Features
  3. Install
  4. CLI Commands
  5. Configuration
  6. Tools
  7. Resources
  8. How It Works
  9. Development
  10. License

claude-memory-fts

Long-term memory MCP server for Claude Code. Stores facts in a local SQLite database with hybrid search (FTS5 + semantic vector similarity) and automatic context injection.

Features

  • Hybrid search — FTS5 keyword search + semantic vector similarity, merged via Reciprocal Rank Fusion (RRF)
  • Semantic understanding — find memories by meaning, not just keywords (powered by all-MiniLM-L6-v2 embeddings)
  • Auto context injection — top 30 most important memories injected into every prompt via hook
  • Importance ranking — facts ranked by access frequency, recency decay, and category weight
  • Access tracking — tracks how often each memory is accessed
  • Upsert — automatically updates existing facts instead of duplicating
  • Categorized — organize by type: preference, decision, technical, project, workflow, personal, general
  • MCP Resources — exposes memory://context resource for session context
  • Zero config — works out of the box, stores data in ~/.claude/memory.db

Install

# Add to Claude Code
claude mcp add memory -- npx claude-memory-fts

# Auto-configure context injection hook (recommended)
npx claude-memory-fts --setup-hook

The --setup-hook command automatically:

  1. Creates ~/.claude/scripts/memory-context.sh
  2. Adds a UserPromptSubmit hook to ~/.claude/settings.json
  3. Top 30 memories are injected into every prompt automatically

CLI Commands

CommandDescription
npx claude-memory-ftsStart MCP server (used by Claude Code)
npx claude-memory-fts --contextOutput top 30 facts (used by hook script)
npx claude-memory-fts --setup-hookAuto-configure context injection hook

Configuration

Environment VariableDefaultDescription
MEMORY_DB_PATH~/.claude/memory.dbPath to the SQLite database file

Example with custom path:

claude mcp add memory -e MEMORY_DB_PATH=/path/to/my/memory.db -- npx claude-memory-fts

Tools

memory_save

Save a fact to long-term memory.

ParameterTypeRequiredDescription
factstringyesThe information to remember
categorystringnoOne of: preference, decision, personal, technical, project, workflow, general

Hybrid search: runs FTS5 and semantic search in parallel, merges results with RRF. Falls back to LIKE for partial matches.

ParameterTypeRequiredDescription
keywordstringyesSearch keyword or phrase
limitnumbernoMax results (default: 10)
memory_update

Update a memory's content or category by ID.

ParameterTypeRequiredDescription
idnumberyesMemory ID
factstringnoNew content (omit to keep current)
categorystringnoNew category (omit to keep current)
memory_list

List all saved memories grouped by category.

ParameterTypeRequiredDescription
categorystringnoFilter by category
limitnumbernoMax results (default: 50)
memory_delete

Delete a memory by ID.

ParameterTypeRequiredDescription
idnumberyesMemory ID

Resources

memory://context

MCP resource exposing top 30 facts ranked by importance score:

  • Access frequency — frequently accessed facts score higher (capped at 20 points)
  • Recency — recently updated facts score higher (10 points, decays over 90 days)
  • Category weight — preference/decision (3), workflow/technical (2), project/personal (1), general (0)

How It Works

Search Pipeline
  1. FTS5 + BM25 and semantic vector similarity run in parallel
  2. Results are merged and deduplicated using Reciprocal Rank Fusion (k=60)
  3. Facts appearing in both lists get naturally boosted
  4. If both return empty, falls back to LIKE substring matching
  5. Access count is tracked on every search hit
Embeddings
  • Model: all-MiniLM-L6-v2 (384 dimensions, ~23MB)
  • Generated locally via @xenova/transformers — no API calls, no data leaves your machine
  • Embeddings are created on save and backfilled on server startup
  • Cosine similarity with 0.3 threshold to filter noise
Storage
  • SQLite with WAL mode for fast concurrent reads/writes
  • FTS5 virtual table synced via triggers for real-time full-text indexing
  • Embeddings stored as BLOB columns alongside facts

Development

git clone https://github.com/kurovu146/claude-memory-mcp.git
cd claude-memory-mcp
npm install
npm run build
npm test

License

MIT

Questions fréquentes

Qu'est-ce que io.github.kurovu146/memory-fts ?

Long-term memory for Claude Code with SQLite FTS5 search and BM25 ranking

Comment installer io.github.kurovu146/memory-fts ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add memory-fts -e 'MEMORY_DB_PATH=<MEMORY_DB_PATH>' -- npx -y claude-memory-fts@1.0.1. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.github.kurovu146/memory-fts ?

Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.

io.github.kurovu146/memory-fts est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient io.github.kurovu146/memory-fts ?

Il est publié par kurovu146. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.