O servidor de memória MCP
que roda na sua máquina.
telys mcp é um servidor de memória MCP stdio local para Claude Code, Claude Desktop, Cursor e Codex. Seu cliente o inicia como subprocesso — sem porta, sem daemon, sem dependência de nuvem. O que o assistente armazena persiste entre sessões, em um repositório governado no seu próprio disco.
Três comandos. Todos os clientes.
O SDK é Apache-2.0. telys login autentica você uma vez, depois provisiona e verifica o runtime assinado com licença de dispositivo — a partir daí, o servidor roda totalmente offline. telys mcp install grava a entrada do servidor na configuração de cada cliente: detecta automaticamente os clientes instalados, mescla de forma idempotente e faz backup de todo arquivo que toca.
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úblico — `pipx install telys` a partir do PyPI, depois `telys login` (gratuito para um desenvolvedor) provisiona o runtime on-device assinado.
Zero variáveis de ambiente. Runtime auto-localizável.
Todos os clientes recebem a mesma entrada canônica: iniciar telys com o único argumento mcp. Sem PYTHONPATH, sem caminhos de kernel, sem chaves na configuração — o runtime se auto-localiza a partir da instalação verificada do telys login.
O transporte é MCP stdio: JSON-RPC 2.0 delimitado por nova linha sobre stdin/stdout, com o cliente gerenciando o ciclo de vida do processo. Quando o próprio CLI do cliente controla seu arquivo de configuração, o instalador o delega — claude mcp add para Claude Code, codex mcp add para Codex.
{
"mcpServers": {
"telys": {
"command": "telys",
"args": ["mcp"]
}
}
}Memória persistente, on-device e governada.
A memória sobrevive à sessão
Notas, decisões e contexto armazenados via telys_add ainda estão lá na próxima sessão, na próxima semana, em um cliente diferente. O repositório é estado compartilhado, não estado de conversa.
Um diretório no seu disco
As memórias residem em ~/.telys/memory, ou onde $TELYS_MEMORY_PATH apontar. Adição e busca executam em processo contra o motor local — offline após telys login, nada sai da máquina no momento da consulta.
Recall com escopo e filtragem
Coleções são particionadas por uma chave de escopo. A busca combina correspondência semântica e lexical e aceita um filtro de igualdade — o mesmo motor que retorna um plano explain em toda consulta do SDK.
| Ferramenta | O que faz |
|---|---|
| telys_search | Busca semântica + lexical em uma coleção de memória. top_k opcional e um filtro de igualdade de chave única. |
| telys_add | Adiciona documentos de texto a uma coleção, criada se ausente. ids e metadados por documento opcionais. |
| telys_create_collection | Cria uma coleção; a chave de partição assume scope por padrão. |
| telys_list_collections | Lista as coleções no repositório. |
| telys_stats | Estatísticas do repositório para uma coleção. |
Inspecione. Remova.
telys mcp status informa onde o servidor está registrado nas configurações de cada cliente. telys mcp uninstall cancela o registro, aceitando as mesmas opções --client e --scope do install e fazendo backup de cada configuração antes de gravar. As mesmas ferramentas de memória também estão disponíveis no 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
O escopo de usuário registra via claude mcp add oficial. O escopo de projeto grava um .mcp.json limpo, exclusivo para MCP, na raiz do repositório — seguro para commit.
claude_desktop_config.json
Mescla a entrada no arquivo de configuração do app no diretório de configuração da plataforma. Reinicie o Claude Desktop para carregar o servidor.
~/.cursor/mcp.json
Grava o mcp.json de nível de usuário, ou .cursor/mcp.json dentro do projeto com --scope project.
codex mcp add ou config.toml
Registra via codex mcp add quando a CLI está presente; caso contrário, acrescenta um bloco [mcp_servers.telys] ao config.toml.
Adicione o Telys ao seu cliente MCP.
O Telys está em beta público (0.1.0b4). O SDK é Apache-2.0 no PyPI — pipx install telys, depois telys login provisiona o runtime on-device assinado, gratuito para um desenvolvedor.