Qu’est-ce que QGIS MCP ?
QGIS MCP, maintenu par Nicolas Karasiak, relie un client MCP à un QGIS Desktop en cours d'exécution via un plugin QGIS. Le plugin, installé depuis le gestionnaire d'extensions de QGIS, fait tourner un serveur de sockets TCP dans la boucle d'événements de QGIS sur le port 9876 de localhost ; le serveur MCP, lancé avec uvx depuis l'archive GitHub, transforme les appels d'outils en commandes PyQGIS. Il prend en charge QGIS 3.28 à 4.x et documente la configuration pour Claude Code, Codex, Gemini CLI, Cursor, VS Code, Claude Desktop et une dizaine d'autres clients.
C'est le serveur QGIS activement maintenu. Le plus connu jjsantos01/qgis_mcp, avec environ 1 140 étoiles, n'a reçu aucun commit depuis le 1er octobre 2025. nkarasiak/qgis-mcp a été créé en mars 2026, compte environ 403 étoiles et a publié la v0.15.2 le 17 octobre 2026. Le plugin est sous GPL v2 ou ultérieure et le serveur MCP sous MIT.
Installer QGIS MCP
uvx --from https://github.com/nkarasiak/qgis-mcp/archive/refs/heads/main.zip qgis-mcp-serverQGIS MCP vaut-il le coup ?
QGIS MCP va bien au-delà des démos du type « charger une couche et l'afficher » auxquelles s'arrêtent la plupart des serveurs SIG. Ses 125 outils couvrent les projets, les couches, l'édition d'entités avec validation et annulation, la calculatrice de champs, la symbologie, les connexions PostgreSQL et le SQL, la calculatrice raster et les statistiques zonales, toute la boîte à outils Processing y compris les modèles et les tâches en arrière-plan, les mises en page et les atlas, plus des points de contrôle qui enregistrent l'état d'une session avant qu'un agent la modifie. Les outils portent les annotations readOnly, destructive et idempotent : un client qui les respecte demande donc confirmation avant de supprimer des entités.
La conception tient compte du coût en contexte. En mode granulaire par défaut, la liste d'outils est longue ; QGIS_MCP_TOOL_MODE=compound la regroupe en 27 outils qui prennent une action et des paramètres, toutes les commandes restant accessibles. Un même serveur peut aussi piloter plusieurs fenêtres QGIS sur des ports différents, chacune avec sa connexion et son verrou, mais cela ne fonctionne pas en mode compound, et le serveur refuse de démarrer plutôt que d'envoyer des écritures à la mauvaise fenêtre.
Le risque tient à un outil. execute_code exécute du PyQGIS arbitraire et, par défaut, le socket n'a pas d'authentification : il écoute sur localhost, mais tout processus local qui atteint le port 9876 peut piloter QGIS. Un secret partagé QGIS_MCP_TOKEN ferme cet accès aux autres utilisateurs, et le plugin refuse d'écouter sur une adresse autre que loopback sans lui, ce qui est le bon comportement par défaut. La ligne d'installation récupère l'archive de la branche main sur GitHub plutôt qu'un paquet à version fixe : une modification de main change donc ce qui s'exécute à la mise à jour suivante.
Face à l'ancien serveur de jjsantos01, le choix n'est pas serré : ce projet a plus d'étoiles et aucun commit depuis treize mois, tandis que celui-ci publie des correctifs toutes les quelques semaines et n'a qu'un ticket ouvert. La limite est celle de toute passerelle QGIS : le modèle doit bien connaître PyQGIS et les noms des algorithmes Processing, et un SCR erroné ou une reprojection silencieuse est aussi facile à commettre pour un agent que pour un analyste débutant.
Là où il fait la différence
Une analyste en aménagement dans un conseil départemental
Produire une série de cartes parcellaires pour chaque canton à partir d'un modèle
Demandez à l'agent de charger les couches des parcelles et des cantons, de créer une mise en page avec carte, légende et barre d'échelle, de configurer un atlas sur les cantons puis d'utiliser export_atlas vers PDF. Gratuit ; le gain est l'heure de réglages de mise en page par série.
Un consultant en environnement qui évalue des sites pour un client
Calculer des statistiques d'occupation du sol pour 40 sites candidats
Demandez zonal_statistics d'un raster d'occupation du sol sur les polygones des sites et exportez la table. Créez d'abord un point de contrôle pour pouvoir annuler un calcul de champ erroné.
Un développeur SIG qui écrit des plugins QGIS
Faire tester par un agent de code les modifications d'un plugin sur un QGIS en cours d'exécution
Utilisez reload_plugin et get_message_log depuis Claude Code pour itérer sans redémarrer QGIS. Définissez QGIS_MCP_TOKEN sur un poste partagé, car sinon execute_code est accessible depuis n'importe quel processus local.
Avant de vous engager
- Mise en route
- Installez le plugin QGIS MCP depuis le gestionnaire d'extensions de QGIS, redémarrez QGIS et cliquez sur Start Server, puis ajoutez uvx --from https://github.com/nkarasiak/qgis-mcp/archive/refs/heads/main.zip qgis-mcp-server au client. L'outil ping renvoie pong quand les deux côtés sont connectés ; diagnose vérifie les versions après une mise à jour.
- Intégrations
- 125 outils couvrant projet, couches, entités, édition, symbologie, connexions, rendu, traitements, mises en page, atlas, requêtes et système, ou 27 en mode compound. Streamable HTTP est disponible via QGIS_MCP_TRANSPORT, et QGIS_MCP_INSTANCES pilote plusieurs fenêtres QGIS.
- Données et confidentialité
- Tout s'exécute en local ; les données cartographiques et les attributs partent vers votre fournisseur de modèles via le client. Le socket sur localhost:9876 n'a pas d'authentification tant que QGIS_MCP_TOKEN n'est pas défini, et execute_code exécute du PyQGIS arbitraire. Les couches web et les connexions PostgreSQL récupèrent des données externes que le modèle lit ensuite.
- Coût à grande échelle
- Gratuit. Le vrai coût, ce sont les tokens : la liste granulaire de 125 outils pèse sur chaque session, et le mode compound la ramène à 27 outils.
- Limites
- Un serveur plus récent qui dialogue avec un plugin plus ancien renvoie des erreurs jusqu'à la mise à jour des deux ; plusieurs instances exigent le mode granulaire. Les longs traitements signalent leur progression via la journalisation MCP au lieu de bloquer le client.
Les points forts
- 125 outils, dont Processing, mises en page, atlas et SQL
- Le mode compound réduit la liste à 27 outils
- Annotations des outils destructifs et points de contrôle de session
- Authentification par token facultative ; sans elle, refus d'écouter sur le réseau
Les points faibles
- execute_code exécute du PyQGIS arbitraire
- Pas d'authentification sur le socket local par défaut
- S'installe depuis l'archive de la branche main, sans version fixe
- Les versions du plugin et du serveur doivent rester alignées
Idéal pour
Les analystes SIG et urbanistes qui veulent qu'un agent exécute des workflows QGIS reproductibles sur leur propre poste.
Alternatives à QGIS MCP
QGIS MCP : questions fréquentes
- QGIS MCP vaut-il le coup ?
- Une passerelle vers QGIS complète et soigneusement construite, qui couvre un vrai travail SIG, des traitements aux atlas, à condition de respecter l'outil d'exécution de code arbitraire qu'elle fournit. Nous lui donnons 4.0 sur 5.
- Combien coûte QGIS MCP ?
- Gratuit et open source (serveur MCP sous MIT, plugin QGIS sous GPL-2.0-or-later). QGIS lui-même est gratuit.
- Quels sont les inconvénients de QGIS MCP ?
- execute_code exécute du PyQGIS arbitraire; pas d'authentification sur le socket local par défaut; s'installe depuis l'archive de la branche main, sans version fixe; les versions du plugin et du serveur doivent rester alignées.
- À qui s’adresse QGIS MCP ?
- Les analystes SIG et urbanistes qui veulent qu'un agent exécute des workflows QGIS reproductibles sur leur propre poste.
- Combien coûte QGIS MCP pour une équipe ou en production ?
- Gratuit. Le vrai coût, ce sont les tokens : la liste granulaire de 125 outils pèse sur chaque session, et le mode compound la ramène à 27 outils.
- QGIS MCP est-il sûr pour les données de l’entreprise ?
- Tout s'exécute en local ; les données cartographiques et les attributs partent vers votre fournisseur de modèles via le client. Le socket sur localhost:9876 n'a pas d'authentification tant que QGIS_MCP_TOKEN n'est pas défini, et execute_code exécute du PyQGIS arbitraire. Les couches web et les connexions PostgreSQL récupèrent des données externes que le modèle lit ensuite.
- Quelles sont les meilleures alternatives à QGIS MCP ?
- Les alternatives les plus proches que nous avons testées sont Google Maps Grounding Lite et MCP for Blender.
Réponses vérifiées le 31 oct. 2026.