QGIS MCP
Références
- Plugin officiel : plugins.qgis.org/plugins/qgis_mcp_plugin — version 0.5.0, compatible QGIS 3.28–4.x
- Dépôt GitHub : nkarasiak/qgis-mcp — 102 outils MCP (couches, traitements, symbologie, export, mise en page/atlas, SQL cross-couches)
Architecture
Claude Code ↔ Serveur MCP Python (uvx) ↔ socket TCP local ↔ Plugin QGIS (dock "QGIS MCP")
Le plugin QGIS crée un serveur TCP local. Le serveur MCP Python (lancé par Claude Code via uvx) s'y connecte. QGIS doit être ouvert et le serveur démarré avant de lancer Claude Code.
Prérequis
Installer uv (gestionnaire de paquets Python) si absent :
winget install astral-sh.uv
Installation
1. Plugin dans QGIS
Extensions > Installer/Gérer les extensions > chercher QGIS MCP > Installer.
Redémarrer QGIS, puis cliquer Start Server dans le dock QGIS MCP.
2. Enregistrer le MCP dans Claude Code
claude mcp add -s user qgis -- uvx --from https://github.com/nkarasiak/qgis-mcp/archive/refs/heads/main.zip qgis-mcp-server
-s user = enregistrement global (tous les projets Claude Code).
3. Vérifier
Dans une session Claude Code avec QGIS ouvert et le serveur démarré, demander diagnose — confirme la synchronisation plugin/serveur MCP.
Ordre de démarrage (à chaque session)
- Ouvrir QGIS
- Cliquer Start Server dans le dock QGIS MCP
- Lancer Claude Code
Authentification (optionnel, machines partagées)
Définir QGIS_MCP_TOKEN=votre-secret dans l'environnement QGIS, redémarrer le serveur, puis ajouter la même variable à la config MCP :
"env": { "QGIS_MCP_TOKEN": "votre-secret" }
Capacités principales
| Catégorie | Exemples |
|---|---|
| Couches | Charger Shapefile, GeoJSON, WMS, PostGIS ; lister, supprimer |
| Traitements | Buffer, intersection, statistiques zonales (1000+ algorithmes) |
| Symbologie | Modifier couleurs, classification, étiquettes |
| Export | PNG, PDF, carte mise en page |
| SQL cross-couches | Requêtes spatiales directement depuis Claude |
| Mise en page/Atlas | Créer et exporter des atlas cartographiques |
Lien avec PostGIS Alteris
La base alteris_geo (79.137.14.202:5432, user alteris_admin) est directement utilisable depuis QGIS MCP : Claude peut interroger PostGIS en SQL spatial, charger le résultat comme couche QGIS, styliser et exporter en PDF — sans intervention manuelle.