QGIS MCP Server-integratie

Wat doet de “QGIS” MCP Server?

De QGIS MCP Server is een Model Context Protocol (MCP)-implementatie die QGIS Desktop verbindt met grote taalmodellen (LLM’s), zoals Claude. Door gebruik te maken van een socket-gebaseerde server en de QGIS MCP-plugin stelt het AI-assistenten in staat om QGIS-projecten direct aan te sturen en ermee te communiceren. Dit maakt AI-gedreven automatisering van taken mogelijk, zoals het aanmaken van projecten, laagmanipulatie, uitvoeren van algoritmes via de Processing Toolbox en zelfs directe Python-code-uitvoering binnen QGIS. De server is ontworpen om geospatiale workflows te stroomlijnen, geavanceerde gegevensverwerking te faciliteren en de productiviteit van ontwikkelaars te verhogen door een naadloos, prompt-ondersteund beheer van QGIS vanuit een LLM-client.

Lijst met prompts

Geen expliciete prompt-sjablonen vermeld in de repository.

Lijst met resources

Geen expliciete MCP-resources beschreven in de repository.

Lijst met tools

• Projectmanipulatie: Hiermee kun je QGIS-projecten aanmaken, laden en opslaan via LLM-commando’s.
• Laagmanipulatie: Maakt het mogelijk om vector- en rasterlagen toe te voegen of te verwijderen in een QGIS-project.
• Verwerking uitvoeren: Voert QGIS-verwerkingsalgoritmes uit (uit de Processing Toolbox) via een LLM-interface.
• Code-uitvoering: Voert willekeurige Python-code uit binnen de QGIS-omgeving via LLM-verzoeken. (Zeer krachtig, gebruik met voorzichtigheid.)

Gebruikssituaties van deze MCP Server

• Geautomatiseerde projectcreatie: Ontwikkelaars en data scientists kunnen LLM’s inzetten om het opzetten van nieuwe QGIS-projecten te automatiseren, wat zorgt voor een consistente structuur en configuratie.
• Geospatiaal datalaagbeheer: LLM’s kunnen programmatisch vector- en rasterlagen toevoegen, verwijderen of bijwerken, waardoor data-invoer en visualisatieworkflows worden gestroomlijnd.
• Batchverwerking via algoritmes: AI-assistenten kunnen complexe QGIS Processing Toolbox-algoritmes uitvoeren op grote datasets, wat tijd bespaart en handmatig werk vermindert.
• Remote code-uitvoering: Gebruikers kunnen Python-scripts verzenden die binnen QGIS worden uitgevoerd, wat aangepaste analyse, datatransformatie of plugin-ontwikkeling mogelijk maakt.
• AI-ondersteunde geospatiale analyse: Door QGIS-functies bloot te stellen aan LLM’s kunnen geavanceerde ruimtelijke queries en kaartbewerkingen conversatiegewijs of via AI-agenten worden uitgevoerd.

Hoe stel je het in

Windsurf

Geen installatie-instructies gevonden voor Windsurf.

Claude

1. Vereisten: Zorg dat QGIS 3.X (getest op 3.22), Python 3.10+ en de uv package manager zijn geïnstalleerd.
2. Download de repository:

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

3. Installeer de QGIS-plugin:
   • Kopieer de map qgis_mcp_plugin naar de pluginmap van je QGIS-profiel (zie README.md voor platform-specifieke locaties).
   • Herstart QGIS en activeer de “QGIS MCP”-plugin.
4. Bewerk de configuratie van Claude:
   • Ga naar Claude > Instellingen > Ontwikkelaar > Configuratie bewerken > claude_desktop_config.json.
   • Voeg het volgende toe onder mcpServers:

     {
       "mcpServers": {
         "qgis": {
           "command": "uv",
           "args": [
             "--directory",
             "/ABSOLUTE/PATH/TO/PARENT/REPO/FOLDER/qgis_mcp/src/qgis_mcp",
             "run",
             "qgis_mcp_server.py"
           ]
         }
       }
     }
     

5. Sla op en herstart Claude om de configuratie toe te passen.

API-sleutels beveiligen

Geen API- of omgevingsvariabelen voor sleutels beschreven in de repo.

Cursor

Geen installatie-instructies gevonden voor Cursor.

Cline

Geen installatie-instructies gevonden voor Cline.

Hoe gebruik je deze MCP in flows

MCP gebruiken in FlowHunt

Om MCP-servers in je FlowHunt-workflow te integreren, begin je met het toevoegen van de MCP-component aan je flow en verbind je deze met je AI-agent:

Klik op de MCP-component om het configuratiepaneel te openen. Voeg in het systeem-MCP-configuratiegedeelte je MCP-servergegevens in met onderstaand JSON-formaat:

{
  "qgis": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Eenmaal geconfigureerd kan de AI-agent deze MCP nu als tool gebruiken met toegang tot al zijn functies en mogelijkheden. Vergeet niet “qgis” te vervangen door de daadwerkelijke naam van je MCP-server en de URL te vervangen door je eigen MCP-server-URL.

Overzicht

Tussen de twee tabellen is de QGIS MCP Server goed gedocumenteerd qua kernfuncties en tool-exposure, maar ontbreken expliciete prompt/resource-lijsten en is er geen info over API-sleutelbeveiliging of sampling/roots-ondersteuning. Ik zou het een 6/10 geven qua MCP-volledigheid en ontwikkelaarsgereedheid.

MCP-score