Neural memory

🧠 Neural Memory v2.0

⚠️ AVISO IMPORTANTE: Esta es una herramienta experimental MCP (Model Context Protocol). Aunque ha mostrado resultados prometedores cuando se usa localmente, todavía está en desarrollo activo y puede evolucionar con el tiempo. ¡Los comentarios y contribuciones son muy apreciados! Por favor, reporta cualquier problema, sugerencia o solicitud de función en nuestra página de Problemas de GitHub. ¡Tu aporte ayuda a mejorar esta herramienta para todos! nya~

---

Sistema de Model Context Protocol (MCP) para memorización de conocimiento y recuperación contextual.

---

🚀 ¡Prueba Neural Memory AHORA!

¿Quieres probarlo de inmediato en tu Cline? Añade esta configuración a tu cline_mcp_settings.json:

{
  "mcpServers": {
    "neural-memory": {
      "timeout": 120,
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@drakonkat/neural-memory@latest"
      ]
    }
  }
}

Para Desarrollo Local

{
  "mcpServers": {
    "neural-memory": {
      "timeout": 120,
      "type": "stdio",
      "command": "node",
      "args": [
        "./neural-memory/src/index.js"
      ]
    }
  }
}

⚠️ Nota: ¡Reemplaza la ruta con la ruta de tu proyecto local!

---

Novedades en v2.0

🎯 Base de Datos Unificada

• ¡No más bases de datos separadas por proyecto! Toda la memoria reside en una única base de datos SQLite
• Más rápido, más simple, cero configuración

🎓 Marco de Habilidades

• Esquema rígido para registrar habilidades con estructura consistente
• framework, language, filePattern, learnSteps, useCases
• Sugerencias automáticas basadas en contexto

📊 Informes HTML

• Genera informes visuales de tu memoria
• Estadísticas, habilidades más usadas, trabajo reciente

Inicio Rápido

import { initialize, handleMcpRequest } from 'neural-memory';

// Initialize the service
await initialize();

// Add a node
await handleMcpRequest('add_node', {
  keywords: ['fastify', 'middleware', 'auth'],
  content: 'Implementation of JWT middleware...',
  type: 'generic'
});

// Register a skill
await handleMcpRequest('register_skill', {
  name: 'Fastify CRUD API',
  framework: 'fastify',
  language: 'javascript',
  filePattern: '**/*.service.js',
  learnSteps: [
    '1. Initialize project',
    '2. Create validation schema',
    '3. Implement handler'
  ],
  useCases: [
    'Create REST API',
    'Handle standardized errors'
  ]
});

// Search for skills
const skills = await handleMcpRequest('suggest_skills', {
  currentKeywords: ['fastify', 'api'],
  domain: 'javascript'
});

// Save context
await handleMcpRequest('save_context_snapshot', {
  summary: 'Refactoring 80% complete',
  pendingTasks: ['Integration testing', 'Deploy to staging'],
  learnings: ['Prisma requires explicit migrations']
});

// Generate report
const report = await handleMcpRequest('get_memory_report', {
  format: 'html'
});

Herramientas Disponibles

Gestión de Nodos

Herramienta	Descripción
add_node	Añadir nodo a la memoria
search_nodes	Buscar nodos (con FTS5 + confianza)
delete_node	Eliminar nodo

Marco de Habilidades

Herramienta	Descripción
register_skill	Registrar habilidad (esquema rígido)
suggest_skills	Sugerir habilidades

Gestión de Contexto

Herramienta	Descripción
save_context_snapshot	Guardar instantánea de contexto
restore_context	Restaurar contexto

Informes

Herramienta	Descripción
get_memory_report	Informe JSON/HTML

Tipos de Nodo

Tipo	Prioridad	Caso de Uso
skill	⭐⭐⭐	Habilidad de conocimiento
error	⭐⭐⭐	Error resuelto
operation	⭐⭐	Cómo hacer
convention	⭐⭐	Reglas de nomenclatura
edge_case	⭐⭐	Caso límite
pattern	⭐	Patrón de diseño
task	⭐	Tarea completada
generic	⭐	Nodo genérico

Puntuación de Confianza

El sistema calcula una puntuación de confianza (0.0-1.0) para cada resultado basándose en:

• Puntuación BM25 (35%) - Clasificación de búsqueda de texto completo
• Coincidencia de palabras clave (25%) - Superposición de palabras clave
• Bonificación por actualidad (10%) - Nodos recientes preferidos
• Puntuación de tipo (15%) - Las habilidades/errores son más importantes
• Peso (15%) - Peso manual

Esquema Rígido de Habilidades

{
  "name": "Skill Name",
  "framework": "fastify|react|prisma|...",
  "language": "javascript|typescript|python|...",
  "filePattern": "**/*.service.js",
  "learnSteps": ["Step 1", "Step 2"],
  "useCases": ["Case 1", "Case 2"],
  "implementation": "// Code...",
  "examples": ["file1.js"],
  "prerequisites": ["Prerequisite 1"]
}

Instalación

npm install neural-memory

Base de Datos

La base de datos unificada se encuentra en:

data/neural-memory-unified.sqlite

Licencia

MIT