Integración del Servidor QGIS MCP

¿Qué hace el Servidor “QGIS” MCP?

El Servidor QGIS MCP es una implementación del Model Context Protocol (MCP) que conecta QGIS Desktop con grandes modelos de lenguaje (LLMs), como Claude. Aprovechando un servidor basado en sockets y el plugin QGIS MCP, permite que asistentes de IA controlen e interactúen directamente con proyectos de QGIS. Esto posibilita la automatización por IA de tareas como la creación de proyectos, manipulación de capas, ejecución de algoritmos mediante el Processing Toolbox e incluso la ejecución directa de código Python dentro de QGIS. El servidor está diseñado para optimizar flujos de trabajo geoespaciales, facilitar el procesamiento avanzado de datos y aumentar la productividad del desarrollador mediante la gestión fluida y asistida por mensajes de QGIS desde un cliente LLM.

Lista de Prompts

No se mencionan plantillas de prompts explícitas en el repositorio.

Lista de Recursos

No se describen recursos MCP explícitos en el repositorio.

Lista de Herramientas

• Manipulación de proyectos: Permite crear, cargar y guardar proyectos QGIS mediante comandos LLM.
• Manipulación de capas: Habilita agregar o eliminar capas vectoriales y raster en un proyecto QGIS.
• Ejecución de procesamiento: Ejecuta algoritmos de procesamiento de QGIS (desde el Processing Toolbox) a través de una interfaz LLM.
• Ejecución de código: Ejecuta código Python arbitrario dentro del entorno QGIS mediante solicitudes LLM. (Extremadamente potente, úsalo con precaución.)

Casos de Uso de este Servidor MCP

• Creación automatizada de proyectos: Desarrolladores y científicos de datos pueden usar LLMs para automatizar la configuración de nuevos proyectos QGIS, asegurando una estructura y configuración coherentes.
• Gestión de capas de datos geoespaciales: Los LLMs pueden agregar, eliminar o actualizar capas vectoriales y raster programáticamente, agilizando la ingestión y visualización de datos.
• Procesamiento por lotes mediante algoritmos: Asistentes de IA pueden activar algoritmos complejos del Processing Toolbox de QGIS en grandes conjuntos de datos, ahorrando tiempo y reduciendo la intervención manual.
• Ejecución remota de código: Los usuarios pueden enviar scripts Python para ser ejecutados dentro de QGIS, facilitando análisis personalizados, transformación de datos o desarrollo de plugins.
• Análisis geoespacial asistido por IA: Al exponer funciones de QGIS a los LLMs, se pueden realizar consultas espaciales avanzadas y operaciones de mapas de forma conversacional o mediante agentes de IA.

Cómo configurarlo

Windsurf

No se encontraron instrucciones de configuración para Windsurf.

Claude

1. Requisitos previos: Asegúrate de tener QGIS 3.X (probado en 3.22), Python 3.10+ y el gestor de paquetes uv instalados.
2. Descarga el repositorio:

   git clone git@github.com:jjsantos01/qgis_mcp.git
   

3. Instala el plugin de QGIS:
   • Copia la carpeta qgis_mcp_plugin a la carpeta de plugins de tu perfil de QGIS (ver README.md para ubicaciones específicas según la plataforma).
   • Reinicia QGIS y habilita el plugin “QGIS MCP”.
4. Edita la configuración de Claude:
   • Ve a Claude > Settings > Developer > Edit Config > claude_desktop_config.json.
   • Agrega lo siguiente bajo mcpServers:

     {
       "mcpServers": {
         "qgis": {
           "command": "uv",
           "args": [
             "--directory",
             "/ABSOLUTE/PATH/TO/PARENT/REPO/FOLDER/qgis_mcp/src/qgis_mcp",
             "run",
             "qgis_mcp_server.py"
           ]
         }
       }
     }
     

5. Guarda y reinicia Claude para aplicar la configuración.

Seguridad de claves API

No se describe el uso de claves API o variables de entorno para claves en el repositorio.

Cursor

No se encontraron instrucciones de configuración para Cursor.

Cline

No se encontraron instrucciones de configuración para Cline.

Cómo usar este MCP en los flujos

Uso de MCP en FlowHunt

Para integrar servidores MCP en tu flujo de trabajo de FlowHunt, comienza añadiendo el componente MCP a tu flujo y conectándolo a tu agente de IA:

Haz clic en el componente MCP para abrir el panel de configuración. En la sección de configuración del sistema MCP, introduce los detalles de tu servidor MCP usando este formato JSON:

{
  "qgis": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Una vez configurado, el agente de IA podrá usar este MCP como herramienta con acceso a todas sus funciones y capacidades. Recuerda cambiar “qgis” por el nombre real de tu servidor MCP y reemplazar la URL por la de tu propio servidor MCP.

Resumen

Entre ambas tablas, el Servidor QGIS MCP está bien documentado en cuanto a funciones principales y herramientas expuestas, pero carece de listados explícitos de prompts/recursos y no cubre la seguridad de claves API ni soporte de muestreo/roots. Le daría una puntuación de 6/10 para completitud MCP y preparación para el desarrollador.

Puntuación MCP