Skip to main content

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.

      Back to top