personal-memory-mcp 0.1.0__tar.gz

personal_memory_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,114 @@
+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

personal_memory_mcp-0.1.0/README.md

@@ -0,0 +1,90 @@
+# 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

personal_memory_mcp-0.1.0/pyproject.toml

@@ -0,0 +1,47 @@
+[project]
+name = "personal-memory-mcp"
+version = "0.1.0"
+description = "Serveur MCP local — mémoire personnelle extraite depuis les historiques IA"
+readme = "README.md"
+license = { text = "MIT" }
+authors = [
+    { name = "Sébastien Etievant", email = "etievant.sebastien@protonmail.com" }
+]
+keywords = ["mcp", "memory", "llm", "ollama", "sqlite", "claude", "ai"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+requires-python = ">=3.13"
+dependencies = [
+    "mcp[cli]>=1.27.1",
+    "sqlite-vec>=0.1.7",
+    "typer>=0.25.1",
+    "rich>=14.0.0",
+    "httpx>=0.28.0",
+    "tomli-w>=1.2.0",
+    "anthropic>=0.102.0",
+]
+
+[project.scripts]
+mmcp = "personal_memory_mcp.cli.main:app"
+
+[build-system]
+requires = ["uv_build>=0.11.2,<0.12.0"]
+build-backend = "uv_build"
+
+[dependency-groups]
+dev = [
+    "pytest>=8.0.0",
+    "pytest-asyncio>=0.25.0",
+    "anthropic>=0.97.0",
+    "playwright>=1.59.0",
+]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["src"]

personal_memory_mcp-0.1.0/src/personal_memory_mcp/__init__.py

@@ -0,0 +1,2 @@
+def hello() -> str:
+    return "Hello from personal-memory-mcp!"

personal_memory_mcp-0.1.0/src/personal_memory_mcp/__main__.py

@@ -0,0 +1,4 @@
+from personal_memory_mcp.cli.main import app
+
+if __name__ == "__main__":
+    app()