QGIS MCP, publicado por Nicolas Karasiak, conecta QGIS Desktop con asistentes IA mediante el Model Context Protocol. El repositorio nkarasiak/qgis-mcp lo presenta como una integración QGIS con servidor FastMCP, socket TCP y plugin QGIS. En la verificación de GitHub del 26 de agosto de 2026, el repositorio tenía licencia GPL-2.0, 257 estrellas y 68 forks, y pyproject indicaba qgis-mcp 0.11.0 con Python 3.12 o superior para el servidor.
Para Educasium, QGIS MCP es el conector SIG de referencia en esta serie. Mapbox MCP es más rápido para mapas de acceso o rutas; QGIS MCP es más adecuado cuando el usuario debe manipular capas, inspeccionar entidades, lanzar algoritmos de tratamiento, producir renders y trabajar dentro de un proyecto QGIS real.
Índice
- Qué hace QGIS MCP
- Arquitectura cliente, servidor y plugin
- Instalación y verificación
- Herramientas SIG expuestas
- Versiones Python y compatibilidad QGIS
- Comparación con Mapbox y EnergyPlus
- Seguridad, límites y producción
- Posición de Educasium
Qué hace QGIS MCP
Resumen: QGIS MCP da a un asistente IA acceso controlado a un proyecto QGIS abierto, con capas, entidades, estilos, tratamientos, renders y composiciones. El README anuncia 118 herramientas y compatibilidad con QGIS 3.28 a 4.x.
Un puente hacia el SIG de escritorio
QGIS es un software SIG de escritorio open source. QGIS MCP no intenta reemplazar la interfaz gráfica; añade una capa conversacional y programable encima del proyecto. Un asistente puede listar capas, inspeccionar una tabla de atributos, modificar entidades, lanzar un algoritmo de tratamiento o generar una salida visual.
Este posicionamiento importa. En SIG, el contexto del proyecto es decisivo: sistema de coordenadas, fuentes de datos, estilos, rutas de archivos, capas temporales, filtros y selecciones. QGIS MCP accede a ese contexto vivo, mientras que Mapbox MCP trabaja sobre todo desde consultas y coordenadas.
Lo que no hay que prometer
El README muestra una cobertura amplia, pero no debe convertirse en una promesa de reemplazar a un especialista SIG. Los resultados dependen de las capas cargadas, su calidad, las proyecciones, los derechos sobre archivos y los plugins instalados en QGIS.
Para una decisión territorial o normativa, el asistente acelera la exploración, pero no valida solo la información. Las capas oficiales, la metodología y las salidas cartográficas deben revisarse.
Arquitectura cliente, servidor y plugin
Resumen: QGIS MCP funciona con tres piezas: cliente IA, servidor MCP FastMCP y plugin QGIS comunicados por socket TCP. El README describe un flujo con cliente, servidor MCP, socket TCP, plugin QGIS con QTimer y API PyQGIS.
Por qué esta arquitectura
QGIS no es solo una API web. El plugin se ejecuta dentro de QGIS y puede acceder al proyecto abierto y a PyQGIS. El servidor MCP aporta la interfaz estándar para clientes IA. La comunicación por socket separa el cliente MCP de la aplicación, manteniendo la acción dentro del proceso controlado por QGIS.
Esta separación tiene una ventaja práctica: el cliente IA puede ser Claude Desktop, Claude Code, Codex CLI, VS Code, Cursor, Gemini CLI, Qwen, Kimi, LM Studio u otros clientes listados en el README. El mismo plugin puede ser pilotado por varios entornos si la configuración es correcta.
Consecuencia para el usuario
El usuario debe mantener QGIS abierto y arrancar el servidor del plugin. Si QGIS está cerrado, el plugin no está iniciado o la socket no es accesible, el servidor MCP no puede actuar sobre el proyecto. Es una restricción normal para un puente hacia una aplicación de escritorio.
En formación conviene mostrar el estado del sistema: QGIS abierto, proyecto cargado, dock QGIS MCP visible, servidor iniciado y cliente MCP conectado. Si no, los errores parecen problemas de IA cuando a menudo son problemas de ciclo de vida de la aplicación.
Instalación y verificación
Resumen: la instalación se verifica con una herramienta ping que debe devolver un pong JSON. Esta prueba simple evita empezar un taller con un puente QGIS roto.
Instalación en QGIS
El README indica instalación desde el gestor de plugins de QGIS: Plugins, Manage and Install Plugins, buscar QGIS MCP, instalar, reiniciar QGIS si hace falta y arrancar el servidor desde el dock widget. Esta parte ocurre dentro de QGIS y depende de la versión local.
El lado cliente usa uvx desde el repositorio GitHub, con el script qgis-mcp-server definido en pyproject.toml. El pyproject verificado declara qgis-mcp 0.11.0, Python >=3.12, mcp[cli] >=1.20.0,<3 y pydantic >=2.11,<3.
Verificación mínima
La prueba documentada es el tool ping, que debe responder {"pong": true}. Es un buen control porque valida el cliente MCP, el servidor Python y la comunicación con QGIS.
Después de ping, el siguiente control debería ser no destructivo: listar capas del proyecto, leer metadatos o inspeccionar la extensión del mapa. Las primeras operaciones de escritura deben probarse sobre una copia del proyecto.
Herramientas SIG expuestas
Resumen: la cobertura incluye capas, entidades, tratamiento, render, estilo, proyecto, conexiones y composiciones. Las 118 herramientas anunciadas deben entenderse como una superficie amplia, no como garantía de dominar cada plugin QGIS.
Familias vistas en el código
La revisión del repositorio identificó handlers de plugin para canvas, connections, features, layers, layout, processing, project, style y system. En el servidor, los archivos src/qgis_mcp/client.py, compound_tools.py, helpers.py, protocol.py y server.py organizan la interfaz MCP.
En la práctica, esto cubre abrir y describir un proyecto, manipular capas, leer y modificar entidades, lanzar tratamientos QGIS, trabajar estilos, producir renders, gestionar composiciones e interrogar el entorno. La fuerza del proyecto viene de su anclaje en QGIS: trabaja con los datos ya presentes en el proyecto.
Casos pedagógicos
Un taller útil puede partir de un proyecto simple: parcelas, equipamientos y transportes. El asistente lista capas, filtra una zona, calcula una intersección, aplica un estilo, produce un mapa y explica hipótesis.
El valor no está solo en automatizar. Está en la trazabilidad: el estudiante ve qué capa se usa, qué algoritmo se ejecuta y qué resultado se crea. El formador puede separar ahorro de tiempo, error de dato y error de razonamiento.
Versiones Python y compatibilidad QGIS
Resumen: el servidor exige Python 3.12+, pero el plugin debe respetar el intérprete Python incluido en QGIS, a veces todavía 3.9. Esta nuance aparece explícitamente en comentarios de pyproject.toml.
Una restricción que explicar
pyproject declara requires-python >=3.12 para el paquete servidor. Pero sus reglas Ruff señalan que el plugin se ejecuta dentro del intérprete incluido en QGIS, y que versiones QGIS posteriores al mínimo 3.28 pueden seguir usando Python 3.9. Los comentarios citan QGIS 3.42 con Python 3.9.
Hay por tanto dos entornos a vigilar: el Python que lanza el servidor MCP y el Python embebido por QGIS para el plugin. Un artículo que diga solo Python 3.12+ es incompleto. Uno que diga solo QGIS 3.28 a 4.x también lo es.
Buen reflejo de instalación
Antes de una formación o integración, conviene anotar versión QGIS, Python embebido, plugin, servidor y cliente MCP. Si una orden falla, esa matriz ayuda a saber si el problema viene del servidor, del plugin, de QGIS o del proyecto abierto.
Este reflejo es especialmente importante en Windows, donde rutas, perfiles de usuario, entornos uv e instalaciones QGIS varían mucho.
Comparación con Mapbox y EnergyPlus
Resumen: QGIS MCP es la buena elección cuando el dato geográfico ya existe como capas, archivos o proyecto SIG. Mapbox MCP es más directo para API de localización y EnergyPlus MCP trabaja modelos energéticos.
| Necesidad | QGIS MCP | Mapbox MCP | EnergyPlus MCP |
|---|---|---|---|
| Trabajar en un proyecto SIG | Muy adecuado | Limitado | Fuera de alcance |
| Listar y modificar capas | Muy adecuado | No central | Fuera de alcance |
| Geocodificar o calcular ruta rápida | Posible según datos | Muy adecuado | Fuera de alcance |
| Simular edificio | Fuera de alcance | Fuera de alcance | Muy adecuado |
| Enseñar método SIG | Muy adecuado | Buen complemento | Complemento energético |
Flujo coherente
Una cadena realista puede empezar con Mapbox MCP para localizar un sitio y formular una hipótesis de acceso. QGIS MCP toma luego el relevo para cruzar capas oficiales, zonificaciones, restricciones y equipamientos. EnergyPlus MCP interviene solo si existe un modelo energético que cargar, modificar o simular.
Esta separación evita un error frecuente: elegir la herramienta más espectacular en vez de la que corresponde al dato. QGIS MCP es menos inmediato que un mapa por API, pero más serio para un expediente SIG.
Seguridad, límites y producción
Resumen: un asistente que controla QGIS puede modificar datos y proyectos; hay que trabajar sobre copias, registrar acciones y revisar salidas. La potencia del SIG aumenta también el riesgo de error silencioso.
Riesgos principales
Los riesgos no son solo informáticos. Una mala proyección, una capa obsoleta, un filtro mal entendido o una modificación de entidades en el archivo incorrecto puede producir un resultado falso pero creíble. Cuando el asistente lanza tratamientos, hay que saber dónde se escriben las salidas y qué capas temporales se crean.
Los proyectos de cliente deben abrirse en copia o bajo control de versión cuando sea posible. Las acciones destructivas deben separarse de las acciones de inspección. El primer uso de una herramienta nueva debe ser no destructivo.
Producción y gobernanza
Para un equipo profesional, QGIS MCP requiere perfiles de proyecto, convenciones de nombres, carpetas de salida y validación humana de mapas finales. El asistente puede producir un primer mapa, pero publicar un plano, análisis normativo o carta cliente sigue siendo responsabilidad profesional.
Esta frontera debe ser clara en Educasium. El lector debe salir con un método: verificar conexión, inspeccionar dato, lanzar tratamiento, controlar resultado y documentar hipótesis.
Posición de Educasium
Resumen: Educasium debe presentar QGIS MCP como método SIG aumentado, no como magia conversacional. Es útil precisamente porque obliga a hablar de capas, tratamientos y pruebas.
Qué enseñar
El mejor ángulo es un ejercicio guiado: cargar un proyecto QGIS, listar capas, formular una pregunta territorial, pedir al asistente que elija un tratamiento, ejecutarlo y verificar en QGIS. El alumno debe ver el resultado y entender la cadena de datos.
Esta pedagogía encaja con Educasium: aprender a trabajar con IA dentro de software profesional sin perder control metodológico. QGIS MCP es una buena página de recurso porque muestra tanto el potencial de los MCP como la necesidad de validación experta.
Siguiente paso
El siguiente paso natural conecta QGIS MCP con Mapbox MCP para mapas rápidos y con EnergyPlus MCP para simulaciones de edificio. Las capas oficiales, sistemas de coordenadas e hipótesis de tratamiento siguen siendo tan importantes como la respuesta del asistente.