MCP Memory Server - Extensão VS Code
Extensão VS Code/Cursor que facilita a instalação e configuração do MCP Memory Server, um servidor MCP (Model Context Protocol) que fornece memória infinita com busca semântica para assistentes de IA.
🎯 Funcionalidades
- ✅ Download automático do JAR do MCP Memory Server
- ✅ Configuração automática do MCP no Cursor/VSCode
- ✅ Validação de pré-requisitos (Java instalado e acessível)
- ✅ Comandos intuitivos para gerenciar a instalação
- ✅ Detecção automática de Cursor vs VSCode
- ✅ Interface amigável com mensagens claras
📋 Requisitos
- VS Code 1.80.0 ou superior, ou Cursor
- Java 21 ou superior instalado e no PATH (ou em locais padrão do sistema)
- Conexão com internet (para download inicial do JAR)
🚀 Instalação
Via Marketplace (Recomendado)
- Abra o VS Code ou Cursor
- Vá para a aba de Extensões (
Ctrl+Shift+X ou Cmd+Shift+X)
- Pesquise por "MCP Memory Server"
- Clique em Instalar
Via VSIX (Manual)
- Baixe o arquivo
.vsix da página de releases
- No VS Code/Cursor, vá em View → Command Palette (
Ctrl+Shift+P ou Cmd+Shift+P)
- Digite "Install from VSIX..."
- Selecione o arquivo
.vsix baixado
📖 Como Usar
Primeira Configuração
Após instalar a extensão, você tem duas opções:
Opção 1: Configuração Automática (Recomendada)
- A extensão detectará automaticamente se o JAR já está baixado
- Se não estiver, execute o comando "MCP Memory Server: Baixar JAR"
- Após o download, a extensão perguntará se deseja configurar automaticamente
- Clique em "Configurar Agora"
Opção 2: Configuração Manual
- Execute o comando "MCP Memory Server: Baixar JAR" (se ainda não baixou)
- Execute o comando "MCP Memory Server: Configurar"
- Confirme a configuração quando solicitado
Comandos Disponíveis
A extensão fornece os seguintes comandos (acessíveis via Command Palette - Ctrl+Shift+P):
- MCP Memory Server: Baixar JAR - Baixa o JAR do servidor MCP do GitHub
- MCP Memory Server: Configurar - Configura o MCP (no .vscode/settings.json no VS Code ou settings.json global no Cursor)
- MCP Memory Server: Validar Instalação - Valida Java, JAR e configuração
- MCP Memory Server: Abrir Configurações - Abre as configurações da extensão
Validação
Para verificar se tudo está configurado corretamente:
- Execute o comando "MCP Memory Server: Validar Instalação"
- A extensão mostrará o status de:
- ✅ Java instalado e versão
- ✅ JAR encontrado
- ✅ Configuração do MCP correta
- ✅ Editor detectado (Cursor ou VSCode)
⚙️ Configurações
A extensão oferece as seguintes configurações (acessíveis em Settings):
- mcpMemoryServer.path - Caminho para o JAR (se vazio, será baixado automaticamente)
- mcpMemoryServer.autoConfigure - Configurar automaticamente após download (padrão:
true)
- mcpMemoryServer.javaPath - Caminho customizado do Java (se vazio, faz scan automático procurando Java 21+ no PATH e locais padrão)
- mcpMemoryServer.jarUrl - URL customizada para download do JAR (se vazio, busca automaticamente a última versão no GitHub via API)
🔧 Troubleshooting
Java não encontrado
Problema: A extensão mostra que Java não está instalado.
Solução:
- Instale Java 21 ou superior
- Certifique-se de que Java está no PATH do sistema ou em locais padrão (a extensão faz scan automático)
- Reinicie o VS Code/Cursor
- Execute novamente a validação
Links para download:
JAR não encontrado ou erro 404 no download
Problema: A extensão não encontra o JAR ou o download falha com erro 404.
Nota: A extensão busca automaticamente a última versão disponível no GitHub via API. Se você quiser usar uma versão específica ou um JAR local, configure a URL manualmente nas configurações.
Solução:
Opção 1: Usar JAR Local (Recomendado se você já tem o JAR)
- Compile o projeto:
mvn clean package
- O JAR estará em
target/mcp-memory-server-1.0.0.jar
- Na extensão, quando aparecer o erro de download, clique em "Usar JAR Local"
- Selecione o arquivo
target/mcp-memory-server-1.0.0.jar
- Ou configure manualmente em Settings →
mcpMemoryServer.path
Opção 2: Configurar Caminho Manualmente
- Abra Settings (
Ctrl+, ou Cmd+,)
- Procure por
mcpMemoryServer.path
- Configure o caminho completo para o JAR (ex:
C:/caminho/para/target/mcp-memory-server-1.0.0.jar)
Opção 3: Criar Release no GitHub
Se você quiser usar o download automático, crie um release no GitHub com o JAR anexado.
Configuração não aplicada
Problema: A configuração do MCP não está funcionando.
Solução:
- Execute o comando "MCP Memory Server: Validar Instalação"
- Se a configuração estiver incorreta, execute "MCP Memory Server: Configurar"
- Reinicie o VS Code/Cursor após configurar (importante!)
Diferenças entre Cursor e VSCode
A extensão detecta automaticamente qual editor está sendo usado:
- Cursor: Configuração global em
settings.json usando mcpServers (funciona para todos os projetos)
- VSCode: Configuração por workspace em
.vscode/settings.json usando mcp.servers (cada projeto tem sua própria configuração)
Importante: No VS Code, cada projeto precisa ser configurado individualmente. Quando você abrir um novo projeto, a extensão detectará se há configuração e poderá pedir para configurar novamente.
📝 O que a Extensão Faz
A extensão automatiza os seguintes passos que normalmente seriam feitos manualmente:
Download do JAR - Busca automaticamente a última versão no GitHub via API e baixa o JAR
Validação de Java - Verifica se Java está instalado e na versão correta (21+)
Scan Automático de Java - Se não configurado, procura automaticamente Java 21+ no PATH e locais padrão do sistema
Configuração do MCP - Adiciona a configuração no local apropriado:
- Cursor: No
settings.json global usando mcpServers (funciona para todos os projetos)
- VS Code: No
.vscode/settings.json do workspace usando mcp.servers (configuração por projeto)
Exemplo de configuração (VS Code - .vscode/settings.json):
{
"mcp.servers": {
"memory": {
"command": "java",
"args": [
"-jar",
"C:/caminho/para/mcp-memory-server.jar",
"--workspace",
"${workspaceFolder}"
]
}
}
}
Exemplo de configuração (Cursor - settings.json global):
{
"mcpServers": {
"memory": {
"command": "java",
"args": [
"-jar",
"C:/caminho/para/mcp-memory-server.jar",
"--workspace",
"${workspaceFolder}"
]
}
}
}
🔗 Links Úteis
📄 Licença
MIT License - Veja o arquivo LICENSE para detalhes.
🤝 Contribuindo
Contribuições são bem-vindas! Por favor, abra uma issue ou pull request no repositório de releases.
📧 Suporte
Se você encontrar problemas ou tiver dúvidas:
- Verifique a seção Troubleshooting
- Abra uma issue no GitHub
- Consulte a documentação completa
Desenvolvido com ❤️ para facilitar o uso do MCP Memory Server
