Metadata-Version: 2.3
Name: personal-memory-mcp
Version: 0.1.0
Summary: Serveur MCP local — mémoire personnelle extraite depuis les historiques IA
Keywords: mcp,memory,llm,ollama,sqlite,claude,ai
Author: Sébastien Etievant
Author-email: Sébastien Etievant <etievant.sebastien@protonmail.com>
License: MIT
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Dist: mcp[cli]>=1.27.1
Requires-Dist: sqlite-vec>=0.1.7
Requires-Dist: typer>=0.25.1
Requires-Dist: rich>=14.0.0
Requires-Dist: httpx>=0.28.0
Requires-Dist: tomli-w>=1.2.0
Requires-Dist: anthropic>=0.102.0
Requires-Python: >=3.13
Description-Content-Type: text/markdown

# personal-memory-mcp

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

```bash
pip install personal-memory-mcp
```

Prérequis : Python 3.13+, [Ollama](https://ollama.com) avec les modèles :

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

## Démarrage rapide

```bash
# 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

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

## Commandes CLI

```bash
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](https://github.com/astral-sh/uv)
- [MCP SDK Anthropic](https://github.com/anthropics/python-sdk)
- SQLite + [sqlite-vec](https://github.com/asg017/sqlite-vec) (stockage vectoriel + FTS5)
- Ollama : `qwen3-embedding:0.6b` (embeddings) + `qwen3:1.7b` (extraction)
- Recherche hybride : cosinus vectoriel + BM25 fallback

## Licence

MIT
