Le serveur mémoire MCP
qui tourne sur votre machine.
telys mcp est un serveur mémoire MCP stdio local pour Claude Code, Claude Desktop, Cursor et Codex. Votre client le lance en sous-processus — aucun port, aucun daemon, aucune dépendance cloud. Ce que l'assistant stocke persiste d'une session à l'autre, dans un store gouverné sur votre propre disque.
Trois commandes. Chaque client.
Le SDK est Apache-2.0. telys login vous connecte une fois, puis provisionne et vérifie le runtime signé sous licence appareil — ensuite, le serveur fonctionne entièrement hors ligne. telys mcp install écrit l'entrée serveur dans la config de chaque client : il détecte automatiquement les clients installés, fusionne de manière idempotente et sauvegarde tout fichier qu'il modifie.
pipx install telys # Apache-2.0 SDK
telys login # one sign-in → signed device license
telys mcp install # register the server in your clients
# defaults: auto-detect installed clients, user scopetelys mcp install --client claude|cursor|codex|claude-desktop|all --scope user|project # defaults: auto-detect installed clients, user scope
Bêta publique — `pipx install telys` depuis PyPI, puis `telys login` (gratuit pour un développeur) provisionne le runtime signé sur appareil.
Zéro variable d'environnement. Runtime auto-localisé.
Chaque client reçoit la même entrée canonique : lancer telys avec le seul argument mcp. Pas de PYTHONPATH, pas de chemins kernel, pas de clés dans la config — le runtime se localise lui-même depuis l'installation vérifiée par telys login.
Le transport est MCP stdio : JSON-RPC 2.0 délimité par des sauts de ligne sur stdin/stdout, le client gérant le cycle de vie du processus. Lorsque le CLI propre d'un client possède son fichier de config, l'installateur lui délègue — claude mcp add pour Claude Code, codex mcp add pour Codex.
{
"mcpServers": {
"telys": {
"command": "telys",
"args": ["mcp"]
}
}
}Mémoire persistante, on-device, gouvernée.
La mémoire survit à la session
Les notes, décisions et contextes stockés via telys_add sont toujours là à la session suivante, la semaine suivante, depuis un autre client. Le store est un état partagé, pas un état de conversation.
Un répertoire sur votre disque
Les mémoires résident dans ~/.telys/memory, ou là où pointe $TELYS_MEMORY_PATH. L'ajout et la recherche s'exécutent en-process contre le moteur local — hors ligne après telys login, rien ne quitte la machine au moment de la requête.
Rappel scopé et filtrable
Les collections se partitionnent par une clé de scope. La recherche combine correspondance sémantique et lexicale et accepte un filtre d'égalité — le même moteur qui retourne un plan explain sur chaque requête SDK.
| Outil | Ce qu'il fait |
|---|---|
| telys_search | Recherche sémantique + lexicale sur une collection mémoire. top_k optionnel et filtre d'égalité à clé unique. |
| telys_add | Ajoute des documents texte à une collection, créée si absente. ids et métadonnées par document optionnels. |
| telys_create_collection | Crée une collection ; la clé de partition prend par défaut la valeur scope. |
| telys_list_collections | Liste les collections du store. |
| telys_stats | Statistiques du store pour une collection. |
Inspectez-le. Supprimez-le.
telys mcp status indique où le serveur est enregistré dans les configurations client. telys mcp uninstall le désenregistre, avec les mêmes options --client et --scope qu'à l'installation, en sauvegardant chaque configuration avant écriture. Les mêmes outils mémoire sont également accessibles depuis le terminal via telys mem.
telys mcp # run the stdio server (what your client launches) telys mcp status # where is the server registered? telys mcp uninstall # deregister (--client / --scope, as at install) telys mcp --path <dir> # point the server at a specific memory root
claude mcp add, ou .mcp.json
Le scope utilisateur s'enregistre via la commande officielle claude mcp add. Le scope projet écrit un fichier .mcp.json propre, dédié au MCP, à la racine du dépôt — sûr à committer.
claude_desktop_config.json
Fusionne l'entrée dans le fichier de configuration de l'application, dans son répertoire de configuration système. Redémarrez Claude Desktop pour charger le serveur.
~/.cursor/mcp.json
Écrit le fichier mcp.json au niveau utilisateur, ou .cursor/mcp.json dans le projet avec --scope project.
codex mcp add, ou config.toml
S'enregistre via codex mcp add si le CLI est présent ; sinon ajoute un bloc [mcp_servers.telys] dans config.toml.
Ajoutez Telys à votre client MCP.
Telys est en bêta publique (0.1.0b4). Le SDK est Apache-2.0 sur PyPI — pipx install telys, puis telys login provisionne le runtime on-device signé, gratuit pour un développeur.