Inked

Inked

Um poderoso servidor MCP para gerenciamento de memória com aplicativos Claude. Rápido, simples e opcionalmente aprimorado com busca por IA.

Recursos

• Busca de texto rápida - Recuperação de memória extremamente rápida por padrão
• Busca com IA - Busca semântica opcional baseada em embeddings atualmente não funcionando a partir de 25/06/25
• Reclassificação com IA - Reclassificação experimental para resultados ainda melhores
• Armazenamento simples - Texto simples armazenado em SQLite (sem sobrecarga de criptografia)
• Seguro - Todos os dados armazenados localmente em ~/.inked/

Instalação

Opção 1: (Recomendada)

npm install -g @frgmt/inked

Opção 2: Desenvolvimento Local

git clone https://github.com/frgmt/inked.git
cd inked
npm install
npm run build
node dist/index.js

Uso Básico

Adicione à sua configuração do servidor MCP:

Padrão (busca de texto rápida):

{
  "mcpServers": {
    "inked": {
      "command": "npx",
      "args": ["@frgmt/inked"]
    }
  }
}

^ Use este. O resto não funcionará. Precisamos resolver alguns problemas.

============IGNORE THIS===========

Com embeddings de IA (busca semântica):

{
  "mcpServers": {
    "inked": {
      "command": "npx",
      "args": ["@frgmt/inked", "--use-embeddings"]
    }
  }
}

Com embeddings + reclassificação de IA (melhores resultados):

{
  "mcpServers": {
    "inked": {
      "command": "npx",
      "args": ["@frgmt/inked", "--use-embeddings", "--use-reranking"]
    }
  }
}

Recursos Experimentais

Busca com IA (Opcional)

O Inked suporta busca experimental baseada em embeddings para recuperação de memória mais sutil.

Modelos de Embedding

Bandeira	Modelo	Uso de Memória	Melhor Para
--use-embeddings	Qwen3-0.6B	~2GB de RAM	Memórias curtas, respostas rápidas
--use-embeddings=4b	Qwen3-4B	~8GB de RAM	Memórias mais longas, melhor nuance
--use-embeddings=8b	Qwen3-8B	~16GB de RAM	Memórias complexas, documentos

Modelos de Reclassificação (Requer embeddings)

Bandeira	Modelo	Memória Adicional	Melhor Para
--use-reranking	Qwen3-Reranker-0.6B	~1GB de RAM	Relevância aprimorada
--use-reranking=4b	Qwen3-Reranker-4B	~4GB de RAM	Melhor qualidade de resultado

Como Escolher Modelos

Para a maioria dos usuários: Comece sem bandeiras (busca de texto rápida)

Para melhor compreensão semântica: Adicione --use-embeddings

• Bom para encontrar memórias pelo significado em vez de palavras exatas
• O primeiro download baixa um modelo de ~2GB (uma única vez)

Para memórias mais longas e com nuances: Use --use-embeddings=4b

• Melhor para entender contexto em textos mais longos
• Lida com relações mais complexas entre ideias

Para melhores resultados: Adicione --use-reranking com embeddings

• A IA reclassifica os principais candidatos para uma classificação ideal
• Melhora significativamente a qualidade da busca

Para usuários avançados: --use-embeddings=8b --use-reranking=4b

• Melhor qualidade de busca possível
• Requer 20+ GB de RAM
• Bom para pesquisa, documentação, projetos complexos

Requisitos de Memória

Configuração	RAM Necessária	Tamanho do Download	Primeira Inicialização
Padrão (texto)	~50MB	0MB	Instantânea
Embeddings básicos	~2GB	~1.2GB	2-5 minutos
Embeddings 4B	~8GB	~4GB	5-10 minutos
Embeddings 8B	~16GB	~8GB	10-20 minutos
+ Reclassificação	+1-4GB	+0.5-2GB	+1-3 minutos

Os modelos são armazenados em cache localmente e baixados apenas uma vez

=============END IGNORE===========

Guia de Uso

Configuração de Memória Automática

Adicione isto às suas configurações/preferências do Claude:

"No início de novas conversas, use a ferramenta Read do inked com 'ALL' para carregar minhas memórias. Só mencione memórias quando forem diretamente relevantes para nossa conversa. Use a ferramenta Write para salvar preferências, fatos ou insights importantes que devem ser lembrados em conversas futuras."

Como Funciona

• Leia uma vez por conversa: As memórias permanecem no contexto após o carregamento inicial
• Operação silenciosa: O Claude usa as memórias sem mencioná-las, a menos que seja relevante
• Escrita inteligente: Salva automaticamente informações importantes para sessões futuras

Quando Escrever Memórias

• Preferências do usuário e estilo de comunicação
• Informações importantes do projeto e contexto
• Tópicos ou temas recorrentes
• Fatos que devem persistir entre conversas
• Insights ou padrões que valem a pena lembrar

Ferramentas

read

Busca e recupera memórias.

Parâmetros:

• search (obrigatório): String de consulta ou "ALL" para tudo
• topr (opcional): Número de resultados (1-5, padrão: 3)

write

Adiciona ou exclui memórias.

Parâmetros:

• content (obrigatório): Texto da memória (NEW) ou consulta de busca (DELETE)
• sTool (obrigatório): "NEW" ou "DELETE"
• id (opcional): ID específico para excluir

Licença

AGPL v3 - Código aberto para uso pessoal. O uso comercial exige abrir o código do seu aplicativo ou obter uma licença comercial.