Neural memory

Uma memória para IA,

Documentação

🧠 Neural Memory v2.0

⚠️ AVISO IMPORTANTE: Esta é uma ferramenta experimental MCP (Model Context Protocol). Embora tenha apresentado resultados promissores quando usada localmente, ainda está em desenvolvimento ativo e pode evoluir com o tempo. Feedback e contribuições são muito bem-vindos! Por favor, relate quaisquer problemas, sugestões ou solicitações de recursos na nossa página de GitHub Issues. Sua contribuição ajuda a tornar esta ferramenta melhor para todos! nya~

Sistema Model Context Protocol (MCP) para memorização de conhecimento e recuperação contextual.

🚀 Experimente o Neural Memory AGORA!

Quer experimentá-lo imediatamente no seu Cline? Adicione esta configuração ao seu cline_mcp_settings.json:

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

Para Desenvolvimento Local

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

⚠️ Nota: Substitua o caminho pelo caminho do seu projeto local!

Novidades na v2.0

🎯 Banco de Dados Unificado

Chega de bancos de dados separados por projeto! Toda a memória reside em um único banco de dados SQLite
Mais rápido, mais simples, zero configuração

🎓 Framework de Skills

Esquema rígido para registrar skills com estrutura consistente
framework, language, filePattern, learnSteps, useCases
Sugestões automáticas baseadas em contexto

📊 Relatórios HTML

Gere relatórios visuais da sua memória
Estatísticas, skills mais usadas, trabalhos recentes

Início 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'
});

Ferramentas Disponíveis

Gerenciamento de Nós

Ferramenta	Descrição
`add_node`	Adicionar nó à memória
`search_nodes`	Buscar nós (com FTS5 + confiança)
`delete_node`	Excluir nó

Framework de Skills

Ferramenta	Descrição
`register_skill`	Registrar skill (esquema rígido)
`suggest_skills`	Sugerir skills

Gerenciamento de Contexto

Ferramenta	Descrição
`save_context_snapshot`	Salvar snapshot de contexto
`restore_context`	Restaurar contexto

Relatórios

Ferramenta	Descrição
`get_memory_report`	Relatório JSON/HTML

Tipos de Nó

Tipo	Prioridade	Caso de Uso
`skill`	⭐⭐⭐	Skill de conhecimento
`error`	⭐⭐⭐	Erro resolvido
`operation`	⭐⭐	How-to
`convention`	⭐⭐	Regras de nomenclatura
`edge_case`	⭐⭐	Caso extremo
`pattern`	⭐	Padrão de design
`task`	⭐	Tarefa concluída
`generic`	⭐	Nó genérico

Pontuação de Confiança

O sistema calcula uma pontuação de confiança (0.0-1.0) para cada resultado com base em:

Pontuação BM25 (35%) - Classificação de busca em texto completo
Correspondência de Palavras-chave (25%) - Sobreposição de palavras-chave
Bônus de Recência (10%) - Nós recentes são preferidos
Pontuação de Tipo (15%) - Skills/erros são mais importantes
Peso (15%) - Peso manual

Esquema Rígido de Skill

{
  "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"]
}

Instalação

npm install neural-memory

Banco de Dados

O banco de dados unificado está localizado em:

data/neural-memory-unified.sqlite

Licença

MIT