¿Qué es QGIS MCP?
QGIS MCP, mantenido por Nicolas Karasiak, conecta un cliente MCP con un QGIS Desktop en ejecución a través de un plugin de QGIS. El plugin, que se instala desde el propio gestor de complementos de QGIS, ejecuta un servidor de sockets TCP dentro del bucle de eventos de QGIS en el puerto 9876 de localhost; el servidor MCP, que se lanza con uvx desde el archivo de GitHub, convierte las llamadas a herramientas en comandos PyQGIS. Admite de QGIS 3.28 a 4.x y documenta la configuración para Claude Code, Codex, Gemini CLI, Cursor, VS Code, Claude Desktop y una decena de clientes más.
Este es el servidor de QGIS con mantenimiento activo. El más conocido jjsantos01/qgis_mcp, con unas 1.140 estrellas, no tiene commits desde el 1 de octubre de 2025. nkarasiak/qgis-mcp se creó en marzo de 2026, tiene unas 403 estrellas y publicó la v0.15.2 el 17 de octubre de 2026. El plugin es GPL v2 o posterior y el servidor MCP, MIT.
Cómo instalar QGIS MCP
uvx --from https://github.com/nkarasiak/qgis-mcp/archive/refs/heads/main.zip qgis-mcp-server¿Merece la pena QGIS MCP?
QGIS MCP va mucho más allá de las demos de «carga una capa y renderízala» en las que se quedan la mayoría de servidores SIG. Sus 125 herramientas cubren proyectos, capas, edición de entidades con confirmación y reversión, calculadora de campos, estilos, conexiones PostgreSQL y SQL, calculadora ráster y estadísticas zonales, toda la caja de herramientas de Processing incluidos modelos y tareas en segundo plano, composiciones de impresión y atlas, además de puntos de control que guardan una instantánea de la sesión antes de que un agente la modifique. Las herramientas llevan anotaciones readOnly, destructive e idempotent, así que un cliente que las respete pide confirmación antes de borrar entidades.
El diseño cuida el coste de contexto. En el modo granular por defecto la lista de herramientas es larga; con QGIS_MCP_TOOL_MODE=compound se agrupa en 27 herramientas que reciben una acción y parámetros, y todos los comandos siguen accesibles. Un mismo servidor puede además manejar varias ventanas de QGIS en distintos puertos, cada una con su propia conexión y bloqueo, aunque eso no funciona en modo compound, y el servidor se niega a arrancar antes que enviar escrituras a la ventana equivocada.
El riesgo está en una herramienta. execute_code ejecuta PyQGIS arbitrario y, por defecto, el socket no tiene autenticación: escucha en localhost, pero cualquier proceso local que llegue al puerto 9876 puede manejar QGIS. Un secreto compartido QGIS_MCP_TOKEN lo cierra a otros usuarios, y el plugin se niega a escuchar en una dirección que no sea de loopback sin él, que es el comportamiento por defecto correcto. La línea de instalación descarga el archivo de la rama main de GitHub en vez de un paquete con versión fija, así que un cambio en main altera lo que se ejecuta en la siguiente actualización.
Frente al antiguo servidor de jjsantos01, la elección no está reñida: ese proyecto tiene más estrellas y ningún commit en trece meses, mientras que este publica correcciones cada pocas semanas y tiene una sola incidencia abierta. El límite es el de todos los puentes con QGIS: el modelo tiene que conocer bien PyQGIS y los nombres de los algoritmos de Processing, y un CRS equivocado o una reproyección silenciosa son tan fáciles de cometer para un agente como para un analista júnior.
Dónde se gana su sitio
Una analista de planificación en un ayuntamiento
Producir una serie de mapas de parcelas para cada distrito a partir de una plantilla
Pide al agente que cargue las capas de parcelas y distritos, prepare una composición con mapa, leyenda y barra de escala, configure un atlas por distritos y use export_atlas a PDF. Gratis; lo que se ahorra es la hora de ajustes de composición por serie.
Un consultor ambiental que evalúa emplazamientos para un cliente
Calcular estadísticas de cobertura del suelo para 40 emplazamientos candidatos
Pide zonal_statistics de un ráster de cobertura del suelo sobre los polígonos de los emplazamientos y exporta la tabla. Crea antes un punto de control para poder revertir un cálculo de campo erróneo.
Un desarrollador SIG que escribe plugins de QGIS
Que un agente de programación pruebe cambios del plugin contra un QGIS en ejecución
Usa reload_plugin y get_message_log desde Claude Code para iterar sin reiniciar QGIS. Define QGIS_MCP_TOKEN en una estación de trabajo compartida, porque si no execute_code es accesible desde cualquier proceso local.
Antes de decidirte
- Puesta en marcha
- Instala el plugin QGIS MCP desde el gestor de complementos de QGIS, reinicia QGIS y pulsa Start Server; después añade uvx --from https://github.com/nkarasiak/qgis-mcp/archive/refs/heads/main.zip qgis-mcp-server al cliente. La herramienta ping devuelve pong cuando ambos lados están conectados; diagnose comprueba las versiones tras actualizar.
- Integraciones
- 125 herramientas para proyecto, capas, entidades, edición, estilos, conexiones, renderizado, geoproceso, composiciones, atlas, consultas y sistema, o 27 en modo compound. Streamable HTTP está disponible mediante QGIS_MCP_TRANSPORT, y QGIS_MCP_INSTANCES maneja varias ventanas de QGIS.
- Datos y privacidad
- Todo se ejecuta en local; los datos del mapa y los atributos van a tu proveedor de modelos a través del cliente. El socket en localhost:9876 no tiene autenticación salvo que se defina QGIS_MCP_TOKEN, y execute_code ejecuta PyQGIS arbitrario. Las capas web y las conexiones PostgreSQL traen datos externos que luego lee el modelo.
- Coste a escala
- Gratis. El coste real son los tokens: la lista granular de 125 herramientas pesa en cada sesión, y el modo compound la reduce a 27 herramientas.
- Límites
- Un servidor más nuevo que hable con un plugin más antiguo devuelve errores hasta que se actualizan ambos; varias instancias necesitan el modo granular. Los geoprocesos largos informan del progreso mediante el logging de MCP en lugar de bloquear el cliente.
Lo bueno
- 125 herramientas, incluidos Processing, composiciones, atlas y SQL
- El modo compound reduce la lista a 27 herramientas
- Anotaciones de herramientas destructivas y puntos de control de sesión
- Autenticación por token opcional; sin ella se niega a escuchar en red
Lo malo
- execute_code ejecuta PyQGIS arbitrario
- Sin autenticación en el socket local por defecto
- Se instala desde el archivo de la rama main, sin versión fija
- Las versiones del plugin y del servidor deben ir a la par
Ideal para
Analistas SIG y urbanistas que quieren que un agente ejecute flujos de trabajo repetibles de QGIS en su propio escritorio.
Alternativas a QGIS MCP
QGIS MCP: preguntas frecuentes
- ¿Merece la pena QGIS MCP?
- Un puente con QGIS completo y bien construido que cubre trabajo SIG real, del geoproceso a los atlas, siempre que respetes la herramienta de código arbitrario que incluye. Le damos un 4.0 sobre 5.
- ¿Cuánto cuesta QGIS MCP?
- Gratuito y de código abierto (servidor MCP MIT, plugin de QGIS GPL-2.0-or-later). QGIS también es gratuito.
- ¿Qué inconvenientes tiene QGIS MCP?
- execute_code ejecuta PyQGIS arbitrario; sin autenticación en el socket local por defecto; se instala desde el archivo de la rama main, sin versión fija; las versiones del plugin y del servidor deben ir a la par.
- ¿Para quién es QGIS MCP?
- Analistas SIG y urbanistas que quieren que un agente ejecute flujos de trabajo repetibles de QGIS en su propio escritorio.
- ¿Cuánto cuesta QGIS MCP para un equipo o en producción?
- Gratis. El coste real son los tokens: la lista granular de 125 herramientas pesa en cada sesión, y el modo compound la reduce a 27 herramientas.
- ¿Es QGIS MCP seguro para los datos de la empresa?
- Todo se ejecuta en local; los datos del mapa y los atributos van a tu proveedor de modelos a través del cliente. El socket en localhost:9876 no tiene autenticación salvo que se defina QGIS_MCP_TOKEN, y execute_code ejecuta PyQGIS arbitrario. Las capas web y las conexiones PostgreSQL traen datos externos que luego lee el modelo.
- ¿Cuáles son las mejores alternativas a QGIS MCP?
- Las alternativas más cercanas que hemos analizado son Google Maps Grounding Lite y MCP for Blender.
Respuestas comprobadas el 31 oct 2026.