Inked

Inked

Un potente servidor MCP para la gestión de memoria con aplicaciones Claude. Rápido, simple y opcionalmente mejorado con búsqueda impulsada por IA.

Características

• Búsqueda de texto rápida - Recuperación de memoria ultrarrápida por defecto
• Búsqueda impulsada por IA - Búsqueda semántica opcional basada en embeddings actualmente no funciona a partir del 25/06/25
• Reordenamiento con IA - Reordenamiento experimental para resultados aún mejores
• Almacenamiento simple - Almacenamiento de texto plano en SQLite (sin sobrecarga de cifrado)
• Seguro - Todos los datos se almacenan localmente en ~/.inked/

Instalación

Opción 1: (Recomendada)

npm install -g @frgmt/inked

Opción 2: Desarrollo Local

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

Uso Básico

Añade a tu configuración del servidor MCP:

Estándar (búsqueda de texto rápida):

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

^ Usa esta. Las demás no funcionarán. Necesito resolver algunos problemas

============IGNORA ESTO===========

Con embeddings de IA (búsqueda semántica):

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

Con embeddings + reordenamiento de IA (mejores resultados):

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

Características Experimentales

Búsqueda Impulsada por IA (Opcional)

Inked admite búsqueda experimental basada en embeddings para una recuperación de memoria más matizada.

Modelos de Embeddings

Indicador	Modelo	Uso de Memoria	Mejor Para
--use-embeddings	Qwen3-0.6B	~2GB de RAM	Memorias cortas, respuestas rápidas
--use-embeddings=4b	Qwen3-4B	~8GB de RAM	Memorias más largas, mejor matiz
--use-embeddings=8b	Qwen3-8B	~16GB de RAM	Memorias complejas, documentos

Modelos de Reordenamiento (Requiere embeddings)

Indicador	Modelo	Memoria Adicional	Mejor Para
--use-reranking	Qwen3-Reranker-0.6B	~1GB de RAM	Relevancia mejorada
--use-reranking=4b	Qwen3-Reranker-4B	~4GB de RAM	Mejor calidad de resultados

Cómo Elegir Modelos

Para la mayoría de usuarios: Comienza sin indicadores (búsqueda de texto rápida)

Para una mejor comprensión semántica: Añade --use-embeddings

• Bueno para encontrar memorias por significado en lugar de palabras exactas
• La primera ejecución descarga un modelo de ~2GB (una sola vez)

Para memorias matizadas y más largas: Usa --use-embeddings=4b

• Mejor para comprender el contexto en textos más largos
• Maneja relaciones más complejas entre ideas

Para mejores resultados: Añade --use-reranking con embeddings

• La IA re-puntúa los mejores candidatos para un ranking óptimo
• Mejora significativamente la calidad de búsqueda

Para usuarios avanzados: --use-embeddings=8b --use-reranking=4b

• La mejor calidad de búsqueda posible
• Requiere 20+ GB de RAM
• Bueno para investigación, documentación, proyectos complejos

Requisitos de Memoria

Configuración	RAM Necesaria	Tamaño de Descarga	Primer Inicio
Predeterminada (texto)	~50MB	0MB	Instantáneo
Embeddings básicos	~2GB	~1.2GB	2-5 minutos
Embeddings 4B	~8GB	~4GB	5-10 minutos
Embeddings 8B	~16GB	~8GB	10-20 minutos
+ Reordenamiento	+1-4GB	+0.5-2GB	+1-3 minutos

Los modelos se almacenan en caché localmente y solo se descargan una vez

=============FIN DE IGNORAR===========

Guía de Uso

Configuración de Auto-Memoria

Añade esto a tu configuración/preferencias de Claude:

"Al inicio de nuevas conversaciones, usa la herramienta Read de Inked con 'ALL' para cargar mis memorias. Solo menciona las memorias cuando sean directamente relevantes para nuestra conversación. Usa la herramienta Write para guardar preferencias, hechos o ideas importantes que deban recordarse para conversaciones futuras."

Cómo Funciona

• Lee una vez por conversación: Las memorias permanecen en contexto después de la carga inicial
• Operación silenciosa: Claude usa las memorias sin mencionarlas a menos que sea relevante
• Escritura inteligente: Guarda automáticamente información importante para sesiones futuras

Cuándo Escribir Memorias

• Preferencias del usuario y estilo de comunicación
• Información importante del proyecto y contexto
• Temas o temas recurrentes
• Hechos que deben persistir entre conversaciones
• Ideas o patrones que valga la pena recordar

Herramientas

read

Busca y recupera memorias.

Parámetros:

• search (obligatorio): Cadena de consulta o "ALL" para todo
• topr (opcional): Número de resultados (1-5, predeterminado: 3)

write

Añade o elimina memorias.

Parámetros:

• content (obligatorio): Texto de memoria (NEW) o consulta de búsqueda (DELETE)
• sTool (obligatorio): "NEW" o "DELETE"
• id (opcional): ID específico para eliminar

Licencia

AGPL v3 - Código abierto para uso personal. El uso comercial requiere abrir el código fuente de tu aplicación u obtener una licencia comercial.