El servidor de memoria MCP
que corre en tu máquina.
telys mcp es un servidor de memoria MCP stdio local para Claude Code, Claude Desktop, Cursor y Codex. Tu cliente lo lanza como subproceso — sin puerto, sin daemon, sin dependencia en la nube. Lo que el asistente almacena persiste entre sesiones, en un almacén gobernado en tu propio disco.
Tres comandos. Cada cliente.
El SDK es Apache-2.0. telys login te autentica una vez, luego aprovisiona y verifica el runtime firmado con licencia de dispositivo — a partir de ahí, el servidor funciona completamente sin conexión. telys mcp install escribe la entrada del servidor en la configuración de cada cliente: detecta automáticamente los clientes instalados, fusiona de forma idempotente y hace copia de seguridad de cada archivo que 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 pública — `pipx install telys` desde PyPI, luego `telys login` (gratis para un desarrollador) aprovisiona el runtime on-device firmado.
Sin variables de entorno. Runtime autolocalizable.
Cada cliente recibe la misma entrada canónica: lanzar telys con el único argumento mcp. Sin PYTHONPATH, sin rutas de kernel, sin claves en la configuración — el runtime se autolocaliza desde la instalación verificada de telys login.
El transporte es MCP stdio: JSON-RPC 2.0 delimitado por saltos de línea sobre stdin/stdout, con el cliente gestionando el ciclo de vida del proceso. Cuando el propio CLI de un cliente gestiona su archivo de configuración, el instalador lo delega — claude mcp add para Claude Code, codex mcp add para Codex.
{
"mcpServers": {
"telys": {
"command": "telys",
"args": ["mcp"]
}
}
}Memoria persistente, en dispositivo y gobernada.
La memoria sobrevive a la sesión
Las notas, decisiones y contexto almacenados mediante telys_add siguen ahí en la siguiente sesión, la semana siguiente, con un cliente diferente. El almacén es estado compartido, no estado de conversación.
Un directorio en tu disco
Los recuerdos residen en ~/.telys/memory, o donde apunte $TELYS_MEMORY_PATH. Las operaciones de adición y búsqueda se ejecutan en proceso contra el motor local — sin conexión tras telys login, nada abandona la máquina en tiempo de consulta.
Recall con ámbito y filtrable
Las colecciones se particionan por una clave de ámbito. La búsqueda combina coincidencia semántica y léxica y acepta un filtro de igualdad — el mismo motor que devuelve un plan explain en cada consulta del SDK.
| Herramienta | Qué hace |
|---|---|
| telys_search | Búsqueda semántica + léxica sobre una colección de memoria. top_k opcional y un filtro de igualdad de clave única. |
| telys_add | Añade documentos de texto a una colección, creándola si no existe. ids opcionales y metadatos por documento. |
| telys_create_collection | Crea una colección; la clave de partición toma por defecto scope. |
| telys_list_collections | Lista las colecciones del almacén. |
| telys_stats | Estadísticas del almacén para una colección. |
Inspecciónalo. Elimínalo.
telys mcp status indica dónde está registrado el servidor en las configuraciones de cliente. telys mcp uninstall lo da de baja, admitiendo las mismas opciones --client y --scope que install y realizando una copia de seguridad de cada configuración antes de escribir. Las mismas herramientas de memoria también están disponibles desde el terminal mediante 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
El ámbito de usuario se registra mediante el oficial claude mcp add. El ámbito de proyecto escribe un .mcp.json limpio, exclusivo de MCP, en la raíz del repositorio — apto para confirmar.
claude_desktop_config.json
Fusiona la entrada en el archivo de configuración de la aplicación, en su directorio de configuración de plataforma. Reinicia Claude Desktop para cargar el servidor.
~/.cursor/mcp.json
Escribe el mcp.json de nivel de usuario, o .cursor/mcp.json dentro del proyecto con --scope project.
codex mcp add, o config.toml
Se registra mediante codex mcp add si la CLI está presente; de lo contrario, añade un bloque [mcp_servers.telys] a config.toml.
Añade Telys a tu cliente MCP.
Telys está en beta pública (0.1.0b4). El SDK es Apache-2.0 en PyPI — pipx install telys, luego telys login aprovisiona el runtime on-device firmado, gratis para un desarrollador.