Nova Mcp

Armazena o contexto, as decisões e o conhecimento do seu projeto localmente em SQLite — sem nuvem, sem telemetria. Seus dados permanecem na sua máquina.

Documentação

Nova Memory

Memória persistente local-first para assistentes de IA. Armazene contexto entre sessões com SQLite.

npm version License: MIT

O que é Nova Memory?

Nova Memory é um servidor MCP (Model Context Protocol) que dá aos assistentes de IA memória persistente. Ele armazena o contexto do seu projeto, decisões e conhecimento localmente em SQLite - sem nuvem, sem telemetria. Seus dados permanecem na sua máquina.

Recursos

  • 22 ferramentas MCP para memória, busca, análise e gerenciamento de tarefas
  • Armazene e busque memórias com busca de texto completo BM25
  • Grafo de conhecimento com navegação de relacionamentos
  • Gerenciamento de tarefas com fases e acompanhamento de progresso
  • Suporte a múltiplos projetos com consultas entre projetos
  • Ativar/desativar ferramentas individuais via configuração
  • Implementação completa em TypeScript com validação Zod

Instalação

npm install -g @nova-mcp/mcp-nova

Configuração

Claude Desktop

Adicione ao seu arquivo de configuração:

  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "nova-memory": {
      "command": "npx",
      "args": ["@nova-mcp/mcp-nova"]
    }
  }
}

Claude Code

claude mcp add nova-memory -- npx @nova-mcp/mcp-nova

Ferramentas Disponíveis

Ferramentas de Memória (8)

FerramentaDescrição
store_memoryArmazena conteúdo com tipo, tags e rastreamento de caminho
memory_searchBusca de texto completo com classificação BM25
memory_queryFiltra por tipo, tags, projeto ou caminho
memory_statsEstatísticas de armazenamento e contagem de memórias
memory_deleteRemove memórias por ID
memory_tagsLista todas as tags com contagens de uso
memory_exportExporta memórias como JSON ou markdown
memory_importImporta memórias em massa a partir de JSON

Ferramentas de Busca (4)

FerramentaDescrição
search_semanticBusca por similaridade semântica
search_patternsEncontra padrões recorrentes em memórias
search_temporalAnálise de memória baseada em tempo
search_relationshipsExplora conexões entre memórias

Ferramentas de Análise (4)

FerramentaDescrição
analysis_conflictsDetecta contradições entre memórias
analysis_memory_mapGera visualização de memória
analysis_anomaliesEncontra padrões incomuns
analysis_forecastPrevê padrões de memória

Ferramentas de Tarefas (3)

FerramentaDescrição
task_managementCria tarefas, fases, acompanha progresso
task_boardVisão geral visual de pendentes/ativas/concluídas
task_insightsAnálise de tarefas com IA

Ferramentas Avançadas (2)

FerramentaDescrição
knowledge_graphConstrói e consulta grafos de relacionamento
project_profileArmazena arquitetura do projeto e informações de stack

Ferramentas de Manutenção (1)

FerramentaDescrição
memory_compactOtimiza e compacta o armazenamento

Configuração

Crie .nova/config.json na raiz do seu projeto:

{
  "storage": {
    "mode": "project"
  },
  "features": {
    "taskManagement": true,
    "knowledgeGraph": true
  },
  "tools": {
    "search_patterns": true,
    "analysis_conflicts": true,
    "project_profile": true
  }
}

Modos de Armazenamento

ModoDescrição
projectArmazena em .nova/memory.db (padrão)
globalArmazena em ~/.nova-memory/memory.db
multiConsulta em múltiplos bancos de dados de projetos

Configuração Multi-Projeto

{
  "storage": {
    "mode": "multi",
    "multiProject": {
      "enabled": true,
      "includePaths": ["~/projects/api", "~/projects/web"]
    }
  }
}

Local de Armazenamento

Todos os dados são armazenados localmente em SQLite:

  • Modo projeto: .nova/memory.db na raiz do projeto
  • Modo global: ~/.nova-memory/memory.db no diretório inicial

Sem serviços em nuvem. Sem chamadas de API externas. Sem telemetria.

Solução de Problemas

  • Ferramentas não aparecendo: Reinicie o Claude Desktop/Code após a instalação
  • Comando não encontrado: Execute npm install -g @nova-mcp/mcp-nova ou verifique o PATH
  • Usuários NVM: Use o caminho completo para o node na configuração do MCP
  • Erros de permissão: Garanta acesso de escrita a .nova ou ao diretório inicial
  • Verificação de versão: Execute mcp-nova --version para verificar a instalação