Guida a si-engine: installazione, scansione, export, MCP

Installazione

Serve il .NET 10 SDK (include il runtime ASP.NET Core).

dotnet tool install -g si-engine
si-engine --version

Se si-engine non viene trovato, aggiungi la cartella dei tool globali al PATH (~/.dotnet/tools su macOS e Linux, %USERPROFILE%\.dotnet\tools su Windows).

dotnet tool update -g si-engine      # aggiornamento
dotnet tool uninstall -g si-engine   # rimozione

Primo avvio

L'area di lavoro (database SQLite, applicazioni, log) è la cartella indicata da SIE_HOME, oppure la cartella corrente.

export SIE_HOME=~/sie
si-engine init
si-engine app add --name "Gestionale" --repository ./Gestionale
si-engine scan --application gestionale

Con il database

Registra l'applicazione con un riferimento alla stringa di connessione, che vive solo nell'ambiente e non viene mai salvata.

export SIE_MIO_DB="Server=...;Database=...;User Id=sie_ro;Password=..."
si-engine app add --name "Gestionale" --repository ./Gestionale --database-ref env:SIE_MIO_DB
si-engine database test --application gestionale
si-engine scan --application gestionale

Basta un account con i soli permessi CONNECT e VIEW DEFINITION. I dati delle tabelle non vengono mai letti.

Database non raggiungibile. L'errore non interrompe la scansione. si-engine emette un warning, prosegue sul solo codice sorgente e nella copertura segna il database come non analizzato, con il motivo. Per saltare del tutto la fase usa --source-only.

Export e ricerca

si-engine export human --application gestionale     # Markdown, Mermaid, CSV
si-engine export llm --application gestionale       # JSON per agenti AI
si-engine search --application gestionale --query ordini
si-engine context --application gestionale --query "modifica gestione ordini" --max-tokens 4000
si-engine impact --application gestionale --target table:dbo.orders

Agenti AI (MCP)

Il server MCP espone 10 tool di sola lettura su stdio. Esempio di configurazione per un client MCP:

{
  "mcpServers": {
    "sie": {
      "command": "si-engine",
      "args": ["--workspace", "/percorso/sie", "mcp", "serve"]
    }
  }
}

Scansioni incrementali

si-engine scan --application gestionale --incremental

Ogni scansione è un'istantanea immutabile: puoi confrontarne due per vedere cosa è cambiato.

Limiti

Area	Stato
Tecnologie	ASP.NET Core / C# e SQL Server. Web Forms, MVC 5 e altri database non sono supportati.
Analisi	Statica: dispatch virtuale, SQL dinamico e codice generato a build-time sono dichiarati come lacune, non indovinati.
Riferimenti	Con `dotnet restore` sull'applicazione analizzata i pacchetti NuGet sono risolti meglio.
Scala	Non misurata su repository molto grandi.