MCP Context Finder
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 (
.vsix ou 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.json no 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
