Integrazione del server MCP QGIS

Cosa fa il server MCP “QGIS”?

Il server QGIS MCP è un’implementazione del Model Context Protocol (MCP) che collega QGIS Desktop con large language model (LLM) come Claude. Grazie a un server basato su socket e al plugin QGIS MCP, consente agli assistenti AI di controllare e interagire direttamente con i progetti QGIS. Ciò permette l’automazione guidata dall’IA di attività come la creazione di progetti, la manipolazione dei layer, l’esecuzione di algoritmi tramite il Processing Toolbox e persino l’esecuzione diretta di codice Python all’interno di QGIS. Il server è progettato per ottimizzare i flussi di lavoro geospaziali, facilitare l’elaborazione avanzata dei dati e aumentare la produttività degli sviluppatori consentendo una gestione fluida e assistita da prompt di QGIS da un client LLM.

Elenco dei Prompt

Nessun template di prompt esplicitamente menzionato nel repository.

Elenco delle Risorse

Nessuna risorsa MCP esplicita descritta nel repository.

Elenco degli Strumenti

• Manipolazione Progetto: Permette la creazione, il caricamento e il salvataggio di progetti QGIS tramite comandi LLM.
• Manipolazione Layer: Consente di aggiungere o rimuovere layer vettoriali e raster in un progetto QGIS.
• Esecuzione Algoritmi: Esegue algoritmi di elaborazione QGIS (dal Processing Toolbox) tramite interfaccia LLM.
• Esecuzione Codice: Esegue codice Python arbitrario nell’ambiente QGIS tramite richieste LLM. (Estremamente potente, usare con cautela.)

Casi d’Uso di questo Server MCP

• Creazione Progetto Automatizzata: Sviluppatori e data scientist possono usare LLM per automatizzare la configurazione di nuovi progetti QGIS, garantendo struttura e configurazione coerenti.
• Gestione Layer Dati Geospaziali: Gli LLM possono aggiungere, rimuovere o aggiornare layer vettoriali e raster in modo programmato, semplificando i flussi di acquisizione e visualizzazione dati.
• Elaborazione in Batch tramite Algoritmi: Gli assistenti AI possono avviare algoritmi complessi del Processing Toolbox QGIS su grandi dataset, risparmiando tempo e riducendo l’intervento manuale.
• Esecuzione Remota di Codice: Gli utenti possono inviare script Python da eseguire in QGIS, facilitando analisi personalizzate, trasformazioni dati o sviluppo di plugin.
• Analisi Geospaziale Assistita da IA: Esporre le funzioni QGIS agli LLM consente di effettuare query spaziali avanzate e operazioni su mappe in modo conversazionale o tramite agenti AI.

Come configurarlo

Windsurf

Nessuna istruzione di configurazione trovata per Windsurf.

Claude

1. Prerequisiti: Assicurati che QGIS 3.X (testato su 3.22), Python 3.10+ e il gestore pacchetti uv siano installati.
2. Scarica il Repository:

   git clone git@github.com:jjsantos01/qgis_mcp.git
   

3. Installa il Plugin QGIS:
   • Copia la cartella qgis_mcp_plugin nella cartella dei plugin del tuo profilo QGIS (vedi README.md per i percorsi specifici per piattaforma).
   • Riavvia QGIS e abilita il plugin “QGIS MCP”.
4. Modifica la Configurazione di Claude:
   • Vai su Claude > Impostazioni > Sviluppatore > Modifica Config > claude_desktop_config.json.
   • Aggiungi quanto segue sotto mcpServers:

     {
       "mcpServers": {
         "qgis": {
           "command": "uv",
           "args": [
             "--directory",
             "/PERCORSO/ASSOLUTO/ALLA/CARTELLA/GENITORE/qgis_mcp/src/qgis_mcp",
             "run",
             "qgis_mcp_server.py"
           ]
         }
       }
     }
     

5. Salva e Riavvia Claude per applicare la configurazione.

Sicurezza delle chiavi API

Nel repository non viene descritto l’uso di API o variabili d’ambiente per le chiavi.

Cursor

Nessuna istruzione di configurazione trovata per Cursor.

Cline

Nessuna istruzione di configurazione trovata per Cline.

Come usare questo MCP all’interno dei flussi

Utilizzo di MCP in FlowHunt

Per integrare i server MCP nel tuo flusso di lavoro FlowHunt, inizia aggiungendo il componente MCP al tuo flusso e collegandolo al tuo agente AI:

Clicca sul componente MCP per aprire il pannello di configurazione. Nella sezione di configurazione MCP di sistema, inserisci i dettagli del tuo server MCP usando questo formato JSON:

{
  "qgis": {
    "transport": "streamable_http",
    "url": "https://iltuomcpserver.esempio/percorsoalmcp/url"
  }
}

Una volta configurato, l’agente AI può ora usare questo MCP come strumento con accesso a tutte le sue funzioni e capacità. Ricorda di cambiare “qgis” con il nome reale del tuo server MCP e sostituire l’URL con quello del tuo server MCP.

Panoramica

Fra le due tabelle, il server QGIS MCP è ben documentato per quanto riguarda le funzionalità principali e l’esposizione degli strumenti, ma manca di prompt/risorse espliciti e non copre la sicurezza delle chiavi API o il supporto sampling/roots. Gli darei un 6/10 per completezza MCP e prontezza per gli sviluppatori.

Punteggio MCP