frkr/mcpsec

Espelho local do registry oficial de servidores MCP
com workflow de autorização por ferramenta, runner de execução estilo inspector
e um proxy MCP que expõe só as ferramentas liberadas a cada agente.
Backend Rust (Loco + Sea-ORM + SQLite/Postgres), frontend React (Vite).
## Funcionalidades
| Área | O que faz |
| Autenticação | Registro com verificação por e-mail, login JWT, recuperação de senha, magic link e reenvio de verificação. Rotas de app exigem sessão. Papéis: hoje todo usuário registrado é admin (users.role, UserRole); a arquitetura já separa o check para papéis menores futuros. |
| Espelho do registry | Sincroniza GET /v0/servers?version=latest paginando até o fim do cursor; novos servidores entram como new + desativados, existentes têm metadados atualizados. |
| Sync agendado | Scheduler dispara registrysynctick a cada minuto; a task decide se o intervalo configurado já venceu. Intervalo e autosyncenabled são runtime. |
| Single-flight | Uma linha running em syncruns atua como lock com lease anti-travamento; syncs concorrentes são descartados, não duplicados. |
| Workflow de ativação | new → activating → awaitingreview → active (rejected/disabled como saídas). O worker conecta no MCP remoto, faz initialize + tools/list e sugere rótulos. |
| Classificação de risco | Cada tool recebe READONLY (lê), WRITE (muda dados, incl. config/credenciais sensíveis) ou ADMIN (executa: comando/código/script ou apaga em massa de forma irreversível) por heurística (classifiedby=heuristic), ajustável na revisão (classifiedby=user). Re-syncs nunca sobrescrevem rótulo revisado; cargo loco task relabeltools re-aplica a heurística nova às linhas ainda heurísticas. |
| Runner (inspector) | Só servidores active. Executa tool via proxy do backend com argumentos em JSON; READONLY livre, WRITE/ADMIN exigem confirmed: true. |
| Auditoria | Toda chamada grava em toolcalls: argumentos, resultado, categoria, confirmação e duração; histórico por servidor nas últimas 50 chamadas. |
| Proxy MCP | Endpoint MCP (Streamable HTTP) em POST /mcp autenticado por bearer token de sessão, com superfície de ferramentas dinâmica. Sem sessão válida, expõe apenas makeauth, a ponte de autorização. |
| makeauth | Tool builtin que responde sem sessão: devolve a URL do painel (/proxy) para o humano logar, criar a sessão e copiar o bearer token. APPBASEURL/PORT controlam o host do link. |
| Sessões e grants | Sessões de proxy por usuário (máx. 10, revogáveis). tooladd libera ferramentas com TTL (padrão 20 min, máx. 24 h); grants expirados são coletados pelo tick. |
| Guarda SSRF | URLs remotas precisam ser https e não podem resolver para loopback, privado, link-local ou porta privada. |
| Configurações | URL do registry, intervalo de sync e auto-sync em appsettings (tela Configurações), com disparo manual de sync. |
| Banco de dados | SQLite por padrão. Migração em voo para Postgres na tela Configurações: schema criado e dados copiados numa transação (ids preservados, sequences resetadas), marcador gravado no SQLite e ativação no restart. Boot resolve DATABASEURL → marcador → SQLite; se o Postgres marcado estiver inacessível, sobe em modo degradado (somente leitura) no SQLite antigo. |