IDE MEMORY MCP

IDE Memory MCP

Memória persistente entre IDEs para agentes de codificação com IA — sua IA lembra de cada projeto, em qualquer IDE.

O Problema

Toda vez que você abre um projeto em um novo IDE ou inicia uma nova conversa com IA, seu assistente de IA esquece tudo:

• O que o projeto faz
• Decisões de arquitetura que você tomou
• No que você está trabalhando atualmente
• Seu progresso e marcos

Você acaba se repetindo. Toda. Única. Vez.

A Solução

IDE Memory MCP dá aos agentes de codificação com IA uma camada de memória persistente que funciona em qualquer IDE compatível com o Model Context Protocol. Escreva o contexto do projeto uma vez — a IA lembra em todos os lugares.

Cursor ←──→ IDE Memory MCP ←──→ VS Code
   ↑              ↓                 ↑
   └── same project memory ────────┘

Principais Recursos

• Memória entre IDEs — O contexto do projeto persiste em Cursor, VS Code, Windsurf, Claude Desktop e qualquer IDE compatível com MCP
• Otimizado para Contexto — Leituras padrão retornam uma tabela resumida compacta, não um despejo de conteúdo que destrói a janela de contexto. A IA carrega apenas o que precisa.
• Avisos Inteligentes — Detecta automaticamente seções desatualizadas (>7 dias), conteúdo superdimensionado (>10 mil caracteres) e sugere poda quando a memória fica antiga (>30 dias)
• Prompts do Agente — Prompts MCP integrados orientam a IA sobre como iniciar sessões, inicializar memória para novos projetos e atualizar memória após mudanças
• Correspondência Inteligente de Projetos — Reconhece projetos por caminho ou URL de repositório git remoto. Mova pastas, troque de máquina — sua memória acompanha.
• Armazenamento Baseado em Seções — Organizado em overview, decisions, active_context, progress + seções personalizadas
• Modo de Anexação — Adicione atualizações incrementais sem reescrever seções inteiras
• Histórico de Versões — Conteúdo anterior é salvo automaticamente antes de cada sobrescrita (últimos 5 snapshots)
• Zero Configuração — Funciona imediatamente. Sem banco de dados, sem nuvem, apenas arquivos markdown locais.

Início Rápido

1. Instalar

# Using uv (recommended)
uv pip install ide-memory-mcp

# Using pip
pip install ide-memory-mcp

2. Configurar Automaticamente Seu IDE

Execute o comando de configuração para detectar e configurar automaticamente os IDEs instalados (Cursor, VS Code, Windsurf, Claude Desktop):

ide-memory-mcp setup

💡 Reinicie seu IDE após executar este comando para ativar o servidor MCP.

Comandos CLI

O pacote ide-memory-mcp inclui comandos práticos para gerenciar sua configuração:

ide-memory-mcp setup

Configura automaticamente o MCP para seus IDEs.

ide-memory-mcp setup              # auto-detect + configure all
ide-memory-mcp setup --cursor     # configure only Cursor
ide-memory-mcp setup --vscode     # configure only VS Code
ide-memory-mcp setup --windsurf   # configure only Windsurf
ide-memory-mcp setup --claude     # configure only Claude Desktop
ide-memory-mcp setup --all        # configure all supported

ide-memory-mcp doctor

Verificação de integridade da sua instalação.

ide-memory-mcp doctor

Verifica a importação do servidor, uso de armazenamento em disco, contagem de projetos e quais IDEs estão configurados.

ide-memory-mcp status

Visão geral rápida de todos os projetos.

ide-memory-mcp status

Lista projetos registrados com contagem de seções, tamanho total e data da última atualização.

{
  "mcpServers": {
    "ide-memory": {
      "command": "ide-memory-mcp"
    }
  }
}

{
  "mcpServers": {
    "ide-memory": {
      "command": "ide-memory-mcp"
    }
  }
}

{
  "mcpServers": {
    "ide-memory": {
      "command": "ide-memory-mcp"
    }
  }
}

{
  "mcpServers": {
    "ide-memory": {
      "command": "ide-memory-mcp"
    }
  }
}

Ferramentas

O IDE Memory MCP expõe 4 ferramentas otimizadas para o agente de IA:

init_project

Registre ou reconecte-se a um projeto. Chame esta ferramenta primeiro em toda conversa.

init_project(projectPath, projectName?, gitRemoteUrl?)

• Novo projeto → cria armazenamento de memória, sugere próximos passos, menciona o prompt bootstrap_memory
• Projeto conhecido → reconecta, retorna resumo da memória com avisos inteligentes:
  • ⚠️ Seções vazias que precisam ser preenchidas
  • ⏰ Seções desatualizadas (>7 dias) que devem ser atualizadas
  • 📦 Seções grandes (>10 mil caracteres) que podem precisar de poda
  • 🧹 Seções antigas (>30 dias) sugerindo uma poda completa

read_memory

Carregamento de memória ciente do contexto. Otimizado para evitar inundar a janela de contexto da IA.

read_memory(projectIdOrPath, sections?, query?, maxChars?, history?, prune?)

💡 Fluxo de trabalho recomendado:

1. read_memory(projectId) → obtenha a tabela resumida (~10 linhas)
2. Decida quais seções são relevantes
3. read_memory(projectId, sections=["overview", "decisions"]) → carregue apenas o que você precisa

write_memory

Escreva em uma ou mais seções de memória.

write_memory(projectIdOrPath, sections, append?, heading?)

• Modo sobrescrita (padrão): Substitui o conteúdo inteiro da seção. O conteúdo anterior é salvo automaticamente no histórico.
• Modo anexação (append=True): Adiciona entradas com carimbo de data/hora sem reescrever. Ótimo para decisões e registros de progresso.

A descrição da ferramenta inclui orientação comportamental — ela informa ao agente de IA quando chamá-la:

• Após mudanças significativas no código
• Quando decisões importantes são tomadas
• Ao final de sessões produtivas
• Quando o usuário pede para "lembrar" algo

manage_projects

Liste ou exclua projetos.

manage_projects(action, projectIdOrPath?, confirm?)

Prompts MCP

O IDE Memory MCP inclui 3 modelos de prompt integrados que orientam o agente de IA em fluxos de trabalho comuns. Eles resolvem o problema do "agente não sabe quando usar a memória".

start_session

Quando: Início de toda conversa.

Orienta o agente através de: inicializar projeto → ler resumo → carregar seções relevantes → verificar conteúdo desatualizado → planejar atualizações de memória para o final da sessão.

bootstrap_memory

Quando: Primeira vez usando IDE Memory em um projeto existente, ou quando o usuário diz "aprenda sobre este projeto".

Orienta o agente através de: analisar README e arquivos de pacote → escrever visão geral abrangente → documentar decisões de arquitetura → definir contexto ativo → registrar progresso.

update_memory

Quando: Final de uma sessão produtiva, após mudanças significativas, ou quando o usuário diz "salve o que fizemos".

Orienta o agente através de: ler memória atual → atualizar active_context → anexar novas decisões → atualizar progresso → atualizar visão geral se necessário → verificar se poda é necessária.

Seções de Memória

Seções padrão criadas para cada projeto:

Seções personalizadas são totalmente suportadas — use qualquer identificador em minúsculas:

write_memory(projectId, {"api_contracts": "...", "testing_notes": "..."})

Avisos Inteligentes

O resumo da memória inclui automaticamente avisos acionáveis:

Armazenamento

Toda a memória é armazenada como arquivos markdown simples em ~/.ide-memory/projects/:

~/.ide-memory/
├── config.json              # Optional configuration
└── projects/
    └── <project_id>/
        ├── meta.json         # Project metadata + timestamps
        ├── overview.md
        ├── decisions.md
        ├── active_context.md
        ├── progress.md
        └── .history/         # Auto-saved snapshots
            ├── overview_20260314_120000.md
            └── decisions_20260314_130000.md

• Nenhum banco de dados necessário
• Todos os arquivos são markdown legível por humanos
• Fácil de fazer backup, versionar ou migrar
• Nenhum dado sai da sua máquina

Configuração

Opcional. Crie ~/.ide-memory/config.json:

{
  "default_sections": [
    "overview",
    "decisions",
    "active_context",
    "progress"
  ]
}

Desenvolvimento

Pré-requisitos

• Python 3.11+
• uv (recomendado) ou pip

Configuração

git clone https://github.com/prasanna-pmpeople/IDE-Memory-MCP.git
cd IDE-Memory-MCP
uv sync

Executar o servidor

uv run ide-memory-mcp

Executar testes

uv run pytest tests/ -v

Testar com o MCP Inspector

npx -y @modelcontextprotocol/inspector uv run ide-memory-mcp

Consulte TESTING.md para o guia completo de testes, incluindo passo a passo do MCP Inspector e testes de batalha entre IDEs.

Compilar o pacote

uv build

Instalar a partir do pacote compilado

pip install dist/ide_memory_mcp-1.0.0-py3-none-any.whl

Como Funciona