MCP-сервер памяти
работающий на вашем устройстве.
telys mcp — локальный stdio MCP-сервер памяти для Claude Code, Claude Desktop, Cursor и Codex. Клиент запускает его как подпроцесс — без порта, без демона, без облачных зависимостей. Всё, что сохраняет ассистент, остаётся доступным между сессиями в управляемом хранилище на вашем диске.
Три команды. Любой клиент.
SDK распространяется под лицензией Apache-2.0. telys login выполняет однократную авторизацию, затем подготавливает и верифицирует подписанный рантайм с привязкой к устройству — после этого сервер работает полностью офлайн. telys mcp install записывает запись сервера в конфигурацию каждого клиента: автоматически определяет установленные клиенты, выполняет идемпотентное слияние и создаёт резервную копию каждого изменяемого файла.
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
Публичная бета — `pipx install telys` из PyPI, затем `telys login` (бесплатно для одного разработчика) устанавливает подписанную среду выполнения на устройстве.
Без переменных окружения. Рантайм самолоцируется.
Все клиенты получают одну и ту же каноническую запись: запуск telys с единственным аргументом mcp. Никакого PYTHONPATH, никаких путей к ядру, никаких ключей в конфиге — рантайм самолоцируется из верифицированной установки telys login.
Транспорт — MCP stdio: JSON-RPC 2.0 с разделением строками через stdin/stdout, при этом клиент управляет жизненным циклом процесса. Там, где собственный CLI клиента владеет файлом конфигурации, установщик делегирует ему — claude mcp add для Claude Code, codex mcp add для Codex.
{
"mcpServers": {
"telys": {
"command": "telys",
"args": ["mcp"]
}
}
}Постоянная, локальная, управляемая память.
Память переживает сессию
Заметки, решения и контекст, сохранённые через telys_add, доступны в следующей сессии, на следующей неделе, в другом клиенте. Хранилище — это общее состояние, а не состояние диалога.
Директория на вашем диске
Воспоминания хранятся в ~/.telys/memory или по пути, указанному в $TELYS_MEMORY_PATH. Добавление и поиск выполняются внутри процесса на локальном движке — офлайн после telys login, ничего не покидает устройство во время запроса.
Скопированный, фильтруемый поиск
Коллекции разделяются по ключу области видимости. Поиск сочетает семантическое и лексическое сопоставление и принимает фильтр равенства — тот же движок, который возвращает план explain для каждого SDK-запроса.
| Инструмент | Что делает |
|---|---|
| telys_search | Семантический и лексический поиск по коллекции памяти. Необязательные top_k и фильтр равенства по одному ключу. |
| telys_add | Добавление текстовых документов в коллекцию, создаваемую при отсутствии. Необязательные ids и метаданные для каждого документа. |
| telys_create_collection | Создание коллекции; ключ партиционирования по умолчанию — scope. |
| telys_list_collections | Список коллекций в хранилище. |
| telys_stats | Статистика хранилища для коллекции. |
Проверьте. Удалите.
telys mcp status показывает, в каких конфигах клиентов зарегистрирован сервер. telys mcp uninstall отменяет регистрацию — принимает те же параметры --client и --scope, что и install, и создаёт резервную копию каждого конфига перед записью. Те же инструменты памяти доступны из терминала через 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 или .mcp.json
User scope регистрируется через официальный claude mcp add. Project scope записывает чистый .mcp.json только для MCP в корень репозитория — безопасно коммитить.
claude_desktop_config.json
Добавляет запись в конфиг приложения в его системной директории. Перезапустите Claude Desktop, чтобы загрузить сервер.
~/.cursor/mcp.json
Записывает пользовательский mcp.json или .cursor/mcp.json внутри проекта при указании --scope project.
codex mcp add или config.toml
Регистрирует через codex mcp add при наличии CLI; иначе добавляет блок [mcp_servers.telys] в config.toml.
Добавьте Telys в свой MCP-клиент.
Telys находится в публичной бете (0.1.0b4). SDK распространяется под Apache-2.0 в PyPI — pipx install telys, затем telys login подготавливает подписанный on-device рантайм, бесплатно для одного разработчика.