Skip to main content

Serveur MCP local — mémoire personnelle extraite depuis les historiques IA

Project description

personal-memory-mcp

PyPI Python License: MIT

Serveur MCP local qui extrait des faits mémorisables depuis vos historiques de conversations IA et les expose à tous les clients MCP compatibles (Claude Code, Claude Desktop, Cursor…).

Fonctionnement

Historiques IA → extraction LLM → SQLite + sqlite-vec → outils MCP

Les faits sont stockés localement dans ~/.personal-memory/memory.db. Aucun cloud, aucune API externe — tout tourne sur votre machine via Ollama.

Installation

pip install personal-memory-mcp

Prérequis : Python 3.13+, Ollama avec les modèles :

ollama pull qwen3:1.7b
ollama pull qwen3-embedding:0.6b

Démarrage rapide

# Lancer le serveur MCP
mmcp serve

# Configurer automatiquement les clients MCP détectés
mmcp setup

# Importer vos sessions Claude Code
mmcp import claude-code

# Importer un export Claude (ZIP)
mmcp import claude ~/Downloads/export.zip

# Importer un export ChatGPT (ZIP)
mmcp import chatgpt ~/Downloads/export.zip

# Interface web locale
mmcp ui

Outils MCP

Outil Description
search(query) Recherche hybride (vectorielle + BM25)
add(contenu, categorie) Ajoute un fait avec déduplication automatique
list_facts(page, categorie) Liste paginée des faits
delete(id) Supprime un fait
import_source(type, chemin) Déclenche un import
import_conversations(source, page) Expose les conversations brutes pour analyse par l'IA

Configuration Claude Code

claude mcp add -s user personal-memory -- mmcp serve

Commandes CLI

mmcp serve                    # Lance le serveur MCP
mmcp ui                       # Interface web http://localhost:8766
mmcp import claude-code       # Import sessions Claude Code
mmcp import claude <zip>      # Import export Claude
mmcp import chatgpt <zip>     # Import export ChatGPT
mmcp export                   # Export JSON/CSV
mmcp backup                   # Sauvegarde SQLite
mmcp restore                  # Restauration
mmcp migrate-embeddings       # Migration de modèle d'embedding
mmcp status                   # État du serveur et de la base

Stack technique

  • Python 3.13 + uv
  • MCP SDK Anthropic
  • SQLite + sqlite-vec (stockage vectoriel + FTS5)
  • Ollama : qwen3-embedding:0.6b (embeddings) + qwen3:1.7b (extraction)
  • Recherche hybride : cosinus vectoriel + BM25 fallback

Licence

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

personal_memory_mcp-0.1.2.tar.gz (32.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

personal_memory_mcp-0.1.2-py3-none-any.whl (44.7 kB view details)

Uploaded Python 3

File details

Details for the file personal_memory_mcp-0.1.2.tar.gz.

File metadata

  • Download URL: personal_memory_mcp-0.1.2.tar.gz
  • Upload date:
  • Size: 32.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.5

File hashes

Hashes for personal_memory_mcp-0.1.2.tar.gz
Algorithm Hash digest
SHA256 a7b997c8e166aed0a042c8e6fd63226202a76ac32cc8014ee76fdf1b95547141
MD5 772810a83fdc3ab9cdb501c29d705d04
BLAKE2b-256 82b8763c1b4e401bf967b9d1c9eca013cde697156e80b9d38047ba19e92afa87

See more details on using hashes here.

File details

Details for the file personal_memory_mcp-0.1.2-py3-none-any.whl.

File metadata

File hashes

Hashes for personal_memory_mcp-0.1.2-py3-none-any.whl
Algorithm Hash digest
SHA256 b8a50a2b9794cc0f7a108fc714513ca8eb4ba6eea502f92df488458c517f945c
MD5 b5af030c083464ecb63cdb8d65a5dfe1
BLAKE2b-256 44f62f483a79f46ef752a2ab5943a58c5b6a0540a9c260ef9ac3b0a1e450d620

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page