SecondBrain (MCP Toolbox)

SecondBrain è un ecosistema di Personal Knowledge Management (PKM) progettato per agenti IA. Utilizza il Model Context Protocol (MCP) per permettere a un'intelligenza artificiale di organizzare, collegare e interrogare informazioni distribuite in molteplici database SQLite.

🧠 Architettura del Server MCP

Il cuore del sistema è il server MCP, alimentato da MCP Toolbox (toolbox.exe) e configurato tramite il file tools.yaml. Questo server espone all'agente IA tre livelli di astrazione:

1. Sources (Sorgenti Dati)

Definiscono le connessioni fisiche ai database SQLite nella cartella dbs/.

• my-sqlite-db: Il database di lavoro principale (testdb.db).
• master-brain: Il database centrale per la persistenza dello stato e dei collegamenti globali.
• Dynamic Sources: Altre sorgenti vengono aggiunte dinamicamente durante la creazione di nuovi database.

2. Native SQL Tools (Strumenti Nativi)

Operazioni SQL dirette eseguite dal server sulle sorgenti configurate:

• db_tables: Elenca le tabelle.
• table_info: Mostra lo schema di una tabella.
• execute_sql: Esegue qualsiasi comando SQL (SELECT, INSERT, UPDATE, DELETE).
• list_table: Ispezione rapida del contenuto.

3. Scripted Prompts (Automazione Avanzata)

Il server utilizza i prompts come wrapper per script complessi (PowerShell e Python) che gestiscono la logica di business e la sicurezza:

• Gestione DB: Creazione, eliminazione sicura (con preview), tagging e protezione (Critical Lock).
• Gestione Tabelle: Creazione guidata, ottimizzazione FTS5 (Full-Text Search) e aggiornamenti sicuri.
• Intelligence: Scansione contestuale tra tutti i database (scan.py) e query in linguaggio naturale (ask.py).
• Bridge & Link: Scoperta e creazione di collegamenti semantici tra record di database diversi.

🚀 Come Avviare il Server

Per esporre le funzionalità del SecondBrain all'agente IA, avvia il server MCP con il seguente comando:

./toolbox.exe --ui --tools-file tools.yaml

L'interfaccia utente sarà disponibile su http://127.0.0.1:5000/, dove potrai monitorare le chiamate agli strumenti in tempo reale.

🛠️ Requisiti Tecnici

• toolbox.exe: Il binario del server MCP Toolbox.
• SQLite3: Installato e presente nel PATH di sistema.
• PowerShell (pwsh): Per l'esecuzione degli script di gestione.
• Python 3.x: Per i motori di ricerca e intelligence.

📂 Struttura del Progetto

• configs/: File di configurazione YAML per i singoli database e prompt.
• dbs/: I file SQLite .db (il "cervello").
• scripts/: Logica operativa in PowerShell e Python.
• tools.yaml: La mappa completa di strumenti e prompt MCP.