Il server di memoria MCP
che gira sulla tua macchina.
telys mcp è un server di memoria MCP stdio locale per Claude Code, Claude Desktop, Cursor e Codex. Il client lo avvia come sottoprocesso — nessuna porta, nessun daemon, nessuna dipendenza cloud. Ciò che l'assistente memorizza persiste tra le sessioni, in uno store governato sul tuo disco.
Tre comandi. Ogni client.
L'SDK è Apache-2.0. telys login ti autentica una volta sola, poi provisiona e verifica il runtime firmato con licenza per dispositivo — dopodiché il server gira completamente offline. telys mcp install scrive la voce del server nella configurazione di ogni client: rileva automaticamente i client installati, unisce in modo idempotente e crea un backup di ogni file che modifica.
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
Beta pubblica — `pipx install telys` da PyPI, poi `telys login` (gratis per un developer) provisiona il runtime firmato on-device.
Zero variabili d'ambiente. Runtime auto-localizzante.
Ogni client riceve la stessa voce canonica: avvia telys con il singolo argomento mcp. Nessun PYTHONPATH, nessun percorso kernel, nessuna chiave in config — il runtime si auto-localizza dall'installazione verificata di telys login.
Il trasporto è MCP stdio: JSON-RPC 2.0 delimitato da newline su stdin/stdout, con il client che gestisce il ciclo di vita del processo. Dove la CLI del client gestisce il proprio file di configurazione, l'installer vi si affida — claude mcp add per Claude Code, codex mcp add per Codex.
{
"mcpServers": {
"telys": {
"command": "telys",
"args": ["mcp"]
}
}
}Memoria persistente, on-device, governata.
La memoria sopravvive alla sessione
Note, decisioni e contesto memorizzati tramite telys_add sono ancora lì nella sessione successiva, la settimana dopo, con un client diverso. Lo store è stato condiviso, non stato di conversazione.
Una directory sul tuo disco
Le memorie risiedono in ~/.telys/memory, o dove punta $TELYS_MEMORY_PATH. Add e search vengono eseguiti in-process sul motore locale — offline dopo telys login, nulla lascia la macchina al momento della query.
Recall con scope e filtri
Le collection si partizionano per scope key. La ricerca combina matching semantico e lessicale e accetta un filtro di uguaglianza — lo stesso motore che restituisce un piano explain su ogni query SDK.
| Tool | Cosa fa |
|---|---|
| telys_search | Ricerca semantica + lessicale su una memory collection. top_k opzionale e un filtro di uguaglianza a chiave singola. |
| telys_add | Aggiunge documenti di testo a una collection, creata se assente. ids e metadati per documento opzionali. |
| telys_create_collection | Crea una collection; la partition key è scope per default. |
| telys_list_collections | Elenca le collection nello store. |
| telys_stats | Statistiche dello store per una collection. |
Ispezionalo. Rimuovilo.
telys mcp status indica dove il server è registrato nelle configurazioni dei client. telys mcp uninstall lo deregistra, accettando le stesse opzioni --client e --scope di install e creando un backup di ogni configurazione prima di scrivere. Gli stessi strumenti di memoria sono disponibili anche dal terminale tramite 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, o .mcp.json
Lo scope utente si registra tramite il comando ufficiale claude mcp add. Lo scope progetto scrive un file .mcp.json pulito, dedicato a MCP, nella root del repository — sicuro da committare.
claude_desktop_config.json
Unisce la voce nel file di configurazione dell'app nella sua directory di configurazione di piattaforma. Riavvia Claude Desktop per caricare il server.
~/.cursor/mcp.json
Scrive il file mcp.json a livello utente, oppure .cursor/mcp.json all'interno del progetto con --scope project.
codex mcp add, o config.toml
Si registra tramite codex mcp add se la CLI è presente; altrimenti aggiunge un blocco [mcp_servers.telys] a config.toml.
Aggiungi Telys al tuo client MCP.
Telys è in beta pubblica (0.1.0b4). L'SDK è Apache-2.0 su PyPI — pipx install telys, poi telys login provisiona il runtime firmato on-device, gratis per un developer.