Der MCP-Memory-Server,
der auf Ihrem Rechner läuft.
telys mcp ist ein lokaler stdio-MCP-Memory-Server für Claude Code, Claude Desktop, Cursor und Codex. Ihr Client startet ihn als Subprocess — kein Port, kein Daemon, keine Cloud-Abhängigkeit. Was der Assistent speichert, bleibt sitzungsübergreifend erhalten, in einem verwalteten Store auf Ihrer eigenen Festplatte.
Drei Befehle. Jeder Client.
Das SDK ist Apache-2.0. telys login meldet Sie einmalig an und stellt dann die signierte, gerätelizenzierte Runtime bereit und verifiziert sie — danach läuft der Server vollständig offline. telys mcp install schreibt den Server-Eintrag in die Konfiguration jedes Clients: Es erkennt installierte Clients automatisch, führt Merges idempotent durch und sichert jede Datei, die es anfasst.
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
Public Beta — `pipx install telys` von PyPI, dann stellt `telys login` (kostenlos für einen Entwickler) die signierte On-Device-Runtime bereit.
Keine Umgebungsvariablen. Selbstlokalisierender Runtime.
Jeder Client erhält denselben kanonischen Eintrag: telys mit dem einzigen Argument mcp starten. Kein PYTHONPATH, keine Kernel-Pfade, keine Schlüssel in der Konfiguration — der Runtime lokalisiert sich selbst aus der verifizierten telys login-Installation.
Der Transport ist MCP stdio: zeilengetrenntes JSON-RPC 2.0 über stdin/stdout, wobei der Client den Prozess-Lifecycle besitzt. Wo das eigene CLI eines Clients seine Konfigurationsdatei verwaltet, überlässt der Installer ihm den Vortritt — claude mcp add für Claude Code, codex mcp add für Codex.
{
"mcpServers": {
"telys": {
"command": "telys",
"args": ["mcp"]
}
}
}Persistenter, On-Device, verwalteter Speicher.
Speicher überdauert die Sitzung
Notizen, Entscheidungen und Kontext, die über telys_add gespeichert wurden, sind in der nächsten Sitzung, der nächsten Woche und bei einem anderen Client noch vorhanden. Der Store ist gemeinsamer Zustand, kein Gesprächszustand.
Ein Verzeichnis auf Ihrer Festplatte
Erinnerungen liegen unter ~/.telys/memory oder wo auch immer $TELYS_MEMORY_PATH zeigt. Hinzufügen und Suchen werden In-Process gegen die lokale Engine ausgeführt — nach telys login offline, nichts verlässt den Rechner zur Abfragezeit.
Scoped, filterbarer Recall
Collections partitionieren nach einem Scope-Key. Die Suche kombiniert semantisches und lexikalisches Matching und akzeptiert einen Gleichheitsfilter — dieselbe Engine, die bei jeder SDK-Abfrage einen explain-Plan zurückgibt.
| Tool | Was es tut |
|---|---|
| telys_search | Semantische + lexikalische Suche über eine Memory-Collection. Optionales top_k und ein Gleichheitsfilter mit einem einzigen Schlüssel. |
| telys_add | Textdokumente zu einer Collection hinzufügen, die bei Bedarf erstellt wird. Optionale IDs und dokumentspezifische Metadaten. |
| telys_create_collection | Eine Collection erstellen; der Partitionsschlüssel ist standardmäßig scope. |
| telys_list_collections | Die Collections im Store auflisten. |
| telys_stats | Store-Statistiken für eine Collection. |
Prüfen. Entfernen.
telys mcp status zeigt, in welchen Client-Konfigurationen der Server registriert ist. telys mcp uninstall hebt die Registrierung auf und akzeptiert dieselben Optionen --client und --scope wie install; vor jedem Schreibvorgang wird ein Backup der jeweiligen Konfiguration erstellt. Dieselben Memory-Tools stehen auch im Terminal über telys mem zur Verfügung.
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 oder .mcp.json
User scope registriert über das offizielle claude mcp add. Project scope schreibt eine saubere, rein MCP-basierte .mcp.json ins Repository-Stammverzeichnis — commit-sicher.
claude_desktop_config.json
Fügt den Eintrag in die Konfigurationsdatei der App im plattformspezifischen Konfigurationsverzeichnis ein. Claude Desktop neu starten, um den Server zu laden.
~/.cursor/mcp.json
Schreibt die mcp.json auf Benutzerebene oder .cursor/mcp.json im Projektverzeichnis mit --scope project.
codex mcp add oder config.toml
Registriert über codex mcp add, sofern die CLI vorhanden ist; andernfalls wird ein [mcp_servers.telys]-Block an config.toml angehängt.
Fügen Sie Telys zu Ihrem MCP-Client hinzu.
Telys befindet sich in der Public Beta (0.1.0b4). Das SDK ist Apache-2.0 auf PyPI — pipx install telys, dann stellt telys login die signierte On-Device-Runtime bereit, kostenlos für einen Entwickler.