Servidor MCP para indexação de comportamento de repositórios — pontos de entrada, impacto, pacotes de contexto antes das edições do agente

Eu venho usando o Cursor em repositórios não triviais e continuo enfrentando o mesmo problema: o agente encontra um arquivo, mas perde rotas, módulos compartilhados e testes que deveriam ser executados após uma alteração.
Eu construí o FlowIndex — um CLI local + servidor MCP que escaneia um repositório e constrói um gráfico de comportamento em SQLite (pontos de entrada, importações/chamadas, testes, co-alterações do git). Sem embeddings, sem SaaS, sem chamadas LLM no próprio índice.
Configuração:
pip install "flowindex[mcp]"
No seu projeto: flowindex init flowindex scan
Adicione ao ~/.cursor/mcp.json (use o caminho absoluto do seu repositório para cwd):
{
"mcpServers": {
"flowindex": {
"command": "flowindex",
"args": ["mcp"],
"cwd": "/caminho/absoluto/para/seu/repo"
}
}
}
4. Reinicie o Cursor — você obtém ferramentas como get_change_impact, suggest_tests, make_context_pack, explain_entrypoint, get_repo_overview.
Exemplo de fluxo de trabalho: antes de editar o código de payments/ledger, peça ao agente para usar make_context_pack ou get_change_impact nesse arquivo — ele puxa do gráfico local , não de uma busca genérica de arquivos.
Limites honestos: análise estática + heurísticas do git apenas. Caminhos de chamada são resolvidos via importações, mas não são de nível de compilador. TS/JS é heurístico. Documentado no README.

MIT · pip install flowindex · https://github.com/adu3110/flowIndex

Curioso se outros usam MCP para contexto de repositório e quais ferramentas você gostaria que existissem. Feliz em corrigir problemas de configuração se alguém tentar.