@andrebuzeli/advanced-context

Servidor MCP (Model Context Protocol) projetado para fornecer memória de longo prazo e indexação de código eficiente para Agentes de IA em IDEs.

🚀 Funcionalidades

• Memória Persistente: Armazena contexto, decisões e aprendizados em um banco de dados SQLite local e otimizado.
• Busca Semântica/Textual (FTS5): Permite que a IA busque memórias e trechos de código instantaneamente.
• Multi-Projeto: Gerencia memórias separadas para cada projeto automaticamente.
• Indexação de Código: Indexa o código fonte do projeto para busca rápida sem precisar ler todos os arquivos.
• Privacidade: Todos os dados ficam na sua máquina local.

📦 Instalação

Você pode rodar o servidor diretamente via npx (recomendado) ou instalar globalmente.

npm install -g @andrebuzeli/advanced-context

⚙️ Configuração

1. Variáveis de Ambiente

O servidor precisa saber onde salvar os dados da memória. Defina a variável MEMORY_STORAGE_PATH.

• MEMORY_STORAGE_PATH: Caminho absoluto para a pasta onde os bancos de dados de memória serão salvos.
  • Exemplo (Windows): C:/Users/SeuUsuario/MCP_Memory
  • Exemplo (Mac/Linux): /home/seuusuario/mcp_memory

Se não definido, será criada uma pasta .mcp-storage no diretório onde o servidor for executado.

2. Configuração no Cliente MCP (Ex: Claude Desktop, VS Code, Trae)

Adicione a seguinte configuração ao seu arquivo de configuração do MCP (ex: claude_desktop_config.json):

{
  "mcpServers": {
    "advanced-context": {
      "command": "npx",
      "args": ["-y", "@andrebuzeli/advanced-context"],
      "env": {
        "MEMORY_STORAGE_PATH": "C:/Caminho/Absoluto/Para/Sua/Pasta/De/Memoria"
      }
    }
  }
}

Nota: Substitua o caminho em MEMORY_STORAGE_PATH por um caminho real e válido na sua máquina. Use barras normais / ou barras duplas \\ no Windows.

🛠️ Ferramentas Disponíveis

O servidor expõe duas ferramentas principais unificadas:

memory_manager

Gerencia a memória de longo prazo e sessões.

• Ações:
  • store: Guarda uma nova memória (ex: decisão de arquitetura, aprendizado).
  • search: Busca memórias existentes.
  • create_session: Inicia uma nova sessão de trabalho.
• Parâmetros: action, projectPath, content, type, tags, q.

codebase_manager

Gerencia a leitura e entendimento do código.

• Ações:
  • index: Varre e indexa arquivos do projeto (suporta .gitignore).
  • search: Busca trechos de código indexados.
• Parâmetros: action, projectPath, patterns (glob), q.

📂 Estrutura de Dados

Os dados são salvos da seguinte forma:

MEMORY_STORAGE_PATH/
  ├── PROJETO_A/
  │   └── memory.db  (SQLite com FTS5)
  ├── PROJETO_B/
  │   └── memory.db
  └── ...

O servidor identifica o projeto automaticamente através do parâmetro projectPath enviado pelo Agente.