Was ist QGIS MCP?
QGIS MCP, gepflegt von Nicolas Karasiak, verbindet einen MCP-Client über ein QGIS-Plugin mit einem laufenden QGIS Desktop. Das Plugin, installiert über QGIS' eigenen Plugin-Manager, betreibt in der Event-Loop von QGIS einen TCP-Socket-Server auf localhost, Port 9876; der MCP-Server, per uvx aus dem GitHub-Archiv gestartet, übersetzt Tool-Aufrufe in PyQGIS-Befehle. Er unterstützt QGIS 3.28 bis 4.x und dokumentiert die Einrichtung für Claude Code, Codex, Gemini CLI, Cursor, VS Code, Claude Desktop und etwa zehn weitere Clients.
Dies ist der aktiv gepflegte QGIS-Server. Das bekanntere jjsantos01/qgis_mcp mit rund 1.140 Sternen hat seit dem 1. Oktober 2025 keinen Commit mehr. nkarasiak/qgis-mcp entstand im März 2026, hat rund 403 Sterne und veröffentlichte v0.15.2 am 17. Oktober 2026. Das Plugin steht unter GPL v2 oder neuer, der MCP-Server unter MIT.
QGIS MCP installieren
uvx --from https://github.com/nkarasiak/qgis-mcp/archive/refs/heads/main.zip qgis-mcp-serverLohnt sich QGIS MCP?
QGIS MCP geht weit über die Demos nach dem Muster „Layer laden und rendern“ hinaus, bei denen die meisten GIS-Server aufhören. Seine 125 Tools decken Projekte, Layer, Feature-Bearbeitung mit Commit und Rollback, Feldrechner, Styling, PostgreSQL-Verbindungen und SQL, Rasterrechner und zonale Statistik ab, die gesamte Processing-Toolbox einschließlich Modellen und Hintergrundjobs, Drucklayouts und Atlanten, dazu Checkpoints, die eine Sitzung sichern, bevor ein Agent sie ändert. Die Tools tragen die Annotationen readOnly, destructive und idempotent, ein Client, der sie beachtet, fragt also nach, bevor er Features löscht.
Das Design achtet auf Kontextkosten. Im standardmäßigen Granular-Modus ist die Tool-Liste groß; mit QGIS_MCP_TOOL_MODE=compound wird sie zu 27 gruppierten Tools zusammengefasst, die eine Aktion und Parameter nehmen, und jeder Befehl bleibt erreichbar. Ein Server kann auch mehrere QGIS-Fenster auf verschiedenen Ports steuern, jedes mit eigener Verbindung und eigener Sperre, das funktioniert allerdings nicht im Compound-Modus, und der Server verweigert lieber den Start, als Schreibzugriffe an das falsche Fenster zu schicken.
Das Risiko steckt in einem Tool. execute_code führt beliebiges PyQGIS aus, und standardmäßig hat der Socket keine Authentifizierung: Er bindet an localhost, aber jeder lokale Prozess, der Port 9876 erreicht, kann QGIS steuern. Ein gemeinsames Geheimnis per QGIS_MCP_TOKEN sperrt andere Nutzer aus, und ohne Token verweigert das Plugin die Bindung an eine Adresse außerhalb von Loopback, was die richtige Voreinstellung ist. Die Installationszeile holt das Archiv des main-Branchs von GitHub statt eines festen Pakets, eine Änderung an main ändert also beim nächsten Aktualisieren, was läuft.
Gegenüber dem älteren Server von jjsantos01 ist die Wahl nicht knapp: Jenes Projekt hat mehr Sterne und seit dreizehn Monaten keinen Commit, während dieses alle paar Wochen Fixes ausliefert und ein offenes Issue hat. Die Grenze ist die jeder QGIS-Brücke: Das Modell muss PyQGIS und die Namen der Processing-Algorithmen gut kennen, und ein falsches CRS oder eine stille Umprojektion passiert einem Agenten so leicht wie einem Junior-Analysten.
Wo es sich lohnt
Eine Planungsanalystin in einer Kreisverwaltung
Aus einer Vorlage eine Flurstückskarten-Serie für jeden Bezirk erstellen
Lass den Agenten die Flurstücks- und Bezirkslayer laden, ein Layout mit Karte, Legende und Maßstabsleiste anlegen, einen Atlas über die Bezirke konfigurieren und per export_atlas als PDF exportieren. Kostenlos; die Ersparnis ist die Stunde Layout-Gefummel pro Serie.
Ein Umweltberater, der Standorte für einen Kunden prüft
Landbedeckungsstatistiken für 40 Kandidatenstandorte berechnen
Fordere zonal_statistics eines Landbedeckungs-Rasters über die Standortpolygone an und exportiere die Tabelle. Leg vorher einen Checkpoint an, damit sich eine fehlerhafte Feldberechnung zurückrollen lässt.
Ein GIS-Entwickler, der QGIS-Plugins schreibt
Einen Coding-Agenten Plugin-Änderungen gegen ein laufendes QGIS testen lassen
Nutze reload_plugin und get_message_log aus Claude Code, um ohne QGIS-Neustart zu iterieren. Setz QGIS_MCP_TOKEN auf einer gemeinsam genutzten Workstation, da execute_code sonst von jedem lokalen Prozess erreichbar ist.
Bevor du dich festlegst
- Einrichtung
- Das QGIS-MCP-Plugin über QGIS' Plugin-Manager installieren, QGIS neu starten und Start Server klicken, dann uvx --from https://github.com/nkarasiak/qgis-mcp/archive/refs/heads/main.zip qgis-mcp-server im Client hinzufügen. Das Tool ping antwortet mit pong, wenn beide Seiten verbunden sind; diagnose prüft nach Updates die Versionen.
- Integrationen
- 125 Tools für Projekt, Layer, Features, Bearbeitung, Styling, Verbindungen, Rendering, Processing, Layouts, Atlas, Abfragen und System, oder 27 im Compound-Modus. Streamable HTTP ist über QGIS_MCP_TRANSPORT verfügbar, und QGIS_MCP_INSTANCES steuert mehrere QGIS-Fenster.
- Daten und Datenschutz
- Alles läuft lokal; Kartendaten und Attribute gehen über den Client an deinen Modellanbieter. Der Socket auf localhost:9876 hat keine Authentifizierung, solange QGIS_MCP_TOKEN nicht gesetzt ist, und execute_code führt beliebiges PyQGIS aus. Web-Layer und PostgreSQL-Verbindungen holen externe Daten, die das Modell dann liest.
- Kosten im großen Maßstab
- Kostenlos. Die eigentlichen Kosten sind Tokens: Die granulare Liste mit 125 Tools belastet jede Sitzung, der Compound-Modus reduziert sie auf 27 Tools.
- Grenzen
- Ein neuerer Server, der mit einem älteren Plugin spricht, liefert Fehler, bis beide aktualisiert sind; mehrere Instanzen brauchen den Granular-Modus. Lange Processing-Läufe melden ihren Fortschritt über MCP-Logging, statt den Client zu blockieren.
Was gut ist
- 125 Tools einschließlich Processing, Layouts, Atlas und SQL
- Der Compound-Modus kürzt die Liste auf 27 Tools
- Annotationen für destruktive Tools und Sitzungs-Checkpoints
- Optionale Token-Authentifizierung; ohne sie keine Bindung ans Netzwerk
Was nicht
- execute_code führt beliebiges PyQGIS aus
- Standardmäßig keine Authentifizierung am lokalen Socket
- Installation aus dem nicht fixierten Archiv des main-Branchs
- Plugin- und Server-Versionen müssen synchron bleiben
Am besten für
GIS-Analysten und Planer, die einen Agenten wiederholbare QGIS-Workflows auf ihrem eigenen Desktop ausführen lassen wollen.
Alternativen zu QGIS MCP
QGIS MCP: häufige Fragen
- Lohnt sich QGIS MCP?
- Eine gründliche, sorgfältig gebaute Brücke zu QGIS, die echte GIS-Arbeit abdeckt, von Processing bis zu Atlas-Layouts, vorausgesetzt, du respektierst das mitgelieferte Tool für beliebigen Code. Wir bewerten es mit 4.0 von 5.
- Was kostet QGIS MCP?
- Kostenlos und Open Source (MCP-Server MIT, QGIS-Plugin GPL-2.0-or-later). QGIS selbst ist kostenlos.
- Welche Nachteile hat QGIS MCP?
- execute_code führt beliebiges PyQGIS aus; Standardmäßig keine Authentifizierung am lokalen Socket; Installation aus dem nicht fixierten Archiv des main-Branchs; Plugin- und Server-Versionen müssen synchron bleiben.
- Für wen eignet sich QGIS MCP?
- GIS-Analysten und Planer, die einen Agenten wiederholbare QGIS-Workflows auf ihrem eigenen Desktop ausführen lassen wollen.
- Was kostet QGIS MCP für ein Team oder im Produktivbetrieb?
- Kostenlos. Die eigentlichen Kosten sind Tokens: Die granulare Liste mit 125 Tools belastet jede Sitzung, der Compound-Modus reduziert sie auf 27 Tools.
- Ist QGIS MCP sicher für Firmendaten?
- Alles läuft lokal; Kartendaten und Attribute gehen über den Client an deinen Modellanbieter. Der Socket auf localhost:9876 hat keine Authentifizierung, solange QGIS_MCP_TOKEN nicht gesetzt ist, und execute_code führt beliebiges PyQGIS aus. Web-Layer und PostgreSQL-Verbindungen holen externe Daten, die das Modell dann liest.
- Was sind die besten Alternativen zu QGIS MCP?
- Die nächsten Alternativen, die wir getestet haben, sind Google Maps Grounding Lite und MCP for Blender.
Antworten geprüft am 31. Okt. 2026.