Extensão para VS Code / Cursor que indexa seu projeto e expõe um servidor MCP local para o agente de IA encontrar arquivos certos — sem ler o projeto inteiro.
Uso em 2 passos
- Instale a extensão (
.vsixou Marketplace) - Abra uma pasta de projeto no Cursor
Pronto. A extensão automaticamente:
- Cria/atualiza o índice em
.mcp-context-finder/ - Inicia o servidor MCP em
http://127.0.0.1:3847/sse(localhost) - Grava
.cursor/mcp.jsonno projeto para o Cursor conectar
Status bar: MCP: running quando tudo estiver ok.
Único passo manual (só na 1ª vez)
No Cursor, atualize os servidores MCP:
- Settings → MCP → Refresh, ou
- Reinicie o Cursor
Depois disso o agente já enxerga as tools get_relevant_context, search_text, etc.
O que o agente ganha
| Tool | Para quê |
|---|---|
get_relevant_context |
Pergunta em linguagem natural → arquivos ranqueados |
search_text |
Busca no código indexado |
search_files |
Busca por nome/path |
read_file_chunk |
Lê só um trecho (máx. 200 linhas) |
get_workspace_info |
Stats do workspace |
detect_project_type |
.NET, React, etc. |
get_git_diff |
Arquivos modificados |
Configurações (opcional)
| Setting | Padrão | Descrição |
|---|---|---|
mcpContextFinder.autoSetup |
true |
Tudo automático ao abrir o projeto |
mcpContextFinder.serverMode |
http |
http = servidor sempre ativo; stdio = Cursor inicia processo |
mcpContextFinder.autoIndexOnStartup |
true |
Indexa ao abrir (usa cache) |
mcpContextFinder.httpPort |
3847 |
Porta do servidor local |
Desative autoSetup se quiser controle manual.
Comandos (avançado)
| Comando | Quando usar |
|---|---|
| Setup MCP (manual) | Forçar reconfiguração |
| Rebuild Index | Após mudanças grandes no código |
| Stop MCP Server | Parar o servidor |
| Show Workspace Info | Ver stats no output |
Desenvolvimento
npm install
npm run compile
# F5 no VS Code
npm test
npm run package # gera .vsix
Segurança
Read-only. Bloqueia .env, chaves, certs e paths fora do workspace. Sem escrita, delete ou shell arbitrário.
Publicar
npx @vscode/vsce publish --packagePath mcp-context-finder-0.2.0.vsix
Ou upload manual em https://marketplace.visualstudio.com/manage