Advanced Memory Bank MCP v7.0.0

🧠 Advanced Memory Bank MCP Server v7.0.0 - Sistema avançado de gerenciamento de memória com ferramentas consolidadas, planejamento robusto, backup inteligente e visualizações interativas.

🚀 O que há de novo na v7.0.0

✨ Consolidação de Ferramentas

Redução de 15 → 6 ferramentas mantendo toda funcionalidade
Interface unificada com ações baseadas em parâmetros
60% menos complexidade na API

🎯 Novas Funcionalidades Principais

1. Sistema de Planejamento Completo

✅ Criação e gerenciamento de planos com etapas
✅ Dependências entre planos e tarefas
✅ Acompanhamento de progresso automatizado
✅ Timeline e caminho crítico
✅ Estimativas de tempo e recursos

2. Sistema de Backup Avançado

✅ Suporte a MEMORY_BACKUP_ROOT
✅ Export/import seletivo de projetos
✅ Metadados e timestamping automático
✅ Backup incremental e filtros

3. Visualização Interativa

✅ Grafos de relacionamentos entre memórias
✅ Timeline de atividades
✅ Análise de conexões e clusters
✅ Estatísticas visuais

4. Análise Unificada

✅ Análise criativa + sequencial combinada
✅ Modo comprehensive (análise completa)
✅ Recomendações inteligentes
✅ Extração automática de tópicos

🛠️ Ferramentas Consolidadas (6 tools)

1. topic-memory-manage

Gerencia memórias por tópicos com ações CRUD unificadas

{
  "tool": "topic-memory-manage",
  "action": "create|read|update|delete|search|list",
  "topic": "architecture", 
  "content": "Decisão arquitetural importante..."
}

2. project-manage

Controle e informações de projetos

{
  "tool": "project-manage", 
  "action": "info|list|reset|initialize",
  "projectName": "meu-projeto"
}

3. analyze-content

Análise unificada de conteúdo

{
  "tool": "analyze-content",
  "action": "creative|sequential|comprehensive", 
  "content": "Conteúdo para analisar..."
}

4. memory-backup

Sistema de backup e restore

{
  "tool": "memory-backup",
  "action": "export|import|sync|restore",
  "includeProjects": ["projeto1", "projeto2"]
}

5. memory-visualize

Visualizações e gráficos

{
  "tool": "memory-visualize", 
  "action": "graph|timeline|connections",
  "includeTopics": true,
  "includePlans": true
}

6. planning-manage

Sistema completo de planejamento

{
  "tool": "planning-manage",
  "action": "create|view|list|update|delete|track|dependency|timeline",
  "title": "Implementar nova feature",
  "steps": [...]
}

🏗️ Configuração

Instalação

npm install -g @andrebuzeli/advanced-memory-bank-mcp

VS Code Settings

{
  "mcp.servers": {
    "advanced-json-memory-bank": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@andrebuzeli/advanced-memory-bank-mcp@7.0.0"],
      "env": {
        "MEMORY_BANK_ROOT": "/path/to/your/memories",
        "MEMORY_BACKUP_ROOT": "/path/to/your/backups"
      }
    }
  }
}

Variáveis de Ambiente

# Diretório principal das memórias
export MEMORY_BANK_ROOT="/path/to/memories"

# Diretório dos backups (novo na v7.0.0)
export MEMORY_BACKUP_ROOT="/path/to/backups"

# Override manual do nome do projeto (opcional)
export MCP_FORCE_PROJECT_NAME="meu-projeto"

📁 Estrutura de Armazenamento

Com MEMORY_BANK_ROOT e MEMORY_BACKUP_ROOT

MEMORY_BANK_ROOT/
├── project-1.json
├── project-2.json
└── project-3.json

MEMORY_BACKUP_ROOT/
├── backup-2024-01-15T10-30-00/
├── backup-2024-01-20T14-45-00/
└── backup-latest/

Padrão (sem variáveis de ambiente)

~/.advanced-memory-bank/
├── project-1.json
├── project-2.json
└── backups/
    └── backup-2024-01-15/

🎯 Exemplos de Uso

📝 Gerenciamento de Memórias

// Criar memória
{
  "tool": "topic-memory-manage",
  "action": "create",
  "topic": "bugs",
  "content": "Bug crítico no checkout",
  "tags": ["critical", "checkout"],
  "importance": 9
}

// Buscar memórias
{
  "tool": "topic-memory-manage", 
  "action": "search",
  "query": "checkout bug",
  "limit": 10
}

📊 Planejamento Avançado

// Criar plano com etapas
{
  "tool": "planning-manage",
  "action": "create", 
  "title": "Refatoração do sistema de autenticação",
  "description": "Modernizar sistema de auth",
  "priority": 8,
  "steps": [
    {
      "title": "Análise do sistema atual",
      "description": "Mapear fluxos existentes",
      "priority": 9
    },
    {
      "title": "Implementar JWT",
      "description": "Substituir sessões por tokens",
      "priority": 8,
      "dependencies": ["step_1"]
    }
  ],
  "tags": ["security", "refactoring"]
}

// Acompanhar progresso
{
  "tool": "planning-manage",
  "action": "track",
  "planId": "plan_xyz"
}

💾 Backup e Restore

// Export seletivo
{
  "tool": "memory-backup",
  "action": "export",
  "includeProjects": ["projeto-importante"],
  "description": "Backup antes da refatoração"
}

// Import de backup
{
  "tool": "memory-backup", 
  "action": "import",
  "targetDirectory": "/path/to/backup-2024-01-15"
}

📈 Visualizações

// Grafo de relacionamentos
{
  "tool": "memory-visualize",
  "action": "graph", 
  "includeTopics": true,
  "includePlans": true,
  "minImportance": 5
}

// Timeline de atividades
{
  "tool": "memory-visualize",
  "action": "timeline",
  "startDate": 1640995200000,
  "includeMemories": true,
  "includePlans": true
}

🔍 Análise de Conteúdo

// Análise abrangente
{
  "tool": "analyze-content",
  "action": "comprehensive",
  "content": "Requisitos para nova funcionalidade..."
}

// Análise sequencial
{
  "tool": "analyze-content", 
  "action": "sequential",
  "content": "Problema complexo para resolver...",
  "thoughtNumber": 1,
  "totalThoughts": 5
}

🆚 Comparação de Versões

Aspecto	v6.x	v7.0.0	Melhoria
Tools	15 separadas	6 consolidadas	60% redução
Planejamento	❌ Não	✅ Completo	Sistema robusto
Backup	❌ Básico	✅ Avançado	MEMORY_BACKUP_ROOT
Visualização	❌ Não	✅ Interativa	Grafos e timeline
Análise	❌ Separada	✅ Unificada	3 modos em 1
Interface	APIs dispersas	API consistente	Experiência unificada

🏗️ Arquitetura v7.0.0

┌─────────────────────────────────────────────────────────────┐
│                    MCP Protocol Layer                      │
├─────────────────────────────────────────────────────────────┤
│                6 Ferramentas Unificadas                    │
│  topic-memory │ project   │ analyze   │ backup │ visualize │
│  planning     │           │           │        │           │
├─────────────────────────────────────────────────────────────┤
│  Planning     │ Backup    │ Visualize │ Unified │ Topic    │
│  Manager      │ Manager   │ Manager   │ Analyzer│ Manager  │
├─────────────────────────────────────────────────────────────┤
│              Core Memory Management Engine                  │
├─────────────────────────────────────────────────────────────┤
│    File System & Storage Layer + Backup Storage Layer     │
└─────────────────────────────────────────────────────────────┘

🔧 Desenvolvimento

# Clone do repositório
git clone https://github.com/andrebuzeli/advanced-memory-bank-mcp.git
cd advanced-memory-bank-mcp

# Instalar dependências
npm install

# Build
npm run build

# Executar localmente
npm start

📖 Migração da v6.x para v7.0.0

✅ Compatibilidade Total

Todas as funcionalidades v6.x mantidas
Arquivos de dados 100% compatíveis
Zero quebra de funcionalidade

🔄 Migração Opcional

# Continuar usando v6.x (compatível)
npm install @andrebuzeli/advanced-memory-bank-mcp@6.3.5

# Migrar para v7.0.0 (recomendado)
npm install @andrebuzeli/advanced-memory-bank-mcp@7.0.0

📋 Mapeamento de Tools

v6.x (15 tools)	v7.0.0 (6 tools)
store-topic-memory	topic-memory-manage (action: create)
get-topic-memory	topic-memory-manage (action: read)
list-topics	topic-memory-manage (action: list)
search-topic-memories	topic-memory-manage (action: search)
update-topic-memory	topic-memory-manage (action: update)
delete-topic-memory	topic-memory-manage (action: delete)
get-project-info	project-manage (action: info)
list-projects	project-manage (action: list)
reset-project	project-manage (action: reset)
initialize-fixed-topics	project-manage (action: initialize)
analyze-creative-content	analyze-content (action: creative)
sequential-thinking	analyze-content (action: sequential)
Novas funcionalidades	memory-backup, memory-visualize, planning-manage

📊 Benefícios da v7.0.0

🎯 Para Desenvolvedores

Interface simplificada: 60% menos tools para aprender
Funcionalidades expandidas: Planejamento, backup e visualização
Experiência consistente: Padrão action-based unificado

🏢 Para Projetos

Gestão robusta: Sistema completo de planejamento
Backup inteligente: Proteção e portabilidade de dados
Insights visuais: Compreensão de relacionamentos
Análise avançada: Múltiplas perspectivas combinadas

🔧 Para Operações

Configuração flexível: MEMORY_BACKUP_ROOT independente
Detecção automática: Nome de projeto inteligente
Compatibilidade: Zero quebra com versões anteriores
Escalabilidade: Arquitetura modular e extensível

🤝 Contribuindo

Fork do repositório
Criar branch de feature (git checkout -b feature/amazing-feature)
Commit das mudanças (git commit -m 'Add amazing feature')
Push para branch (git push origin feature/amazing-feature)
Abrir Pull Request

📄 Licença

Projeto licenciado sob MIT License - veja LICENSE para detalhes.

🔗 Links

📊 Histórico de Versões

v7.0.0 - Ferramentas consolidadas, sistema de planejamento, backup avançado, visualizações
v6.3.5 - Sistema estável de tópicos com MEMORY_BANK_ROOT
v5.x - Versões anteriores com gerenciamento básico de memória

Made with ❤️ by André Buzeli

@andrebuzeli/advanced-memory-bank-mcp