Integração do Servidor QGIS MCP

O que o Servidor “QGIS” MCP faz?

O Servidor QGIS MCP é uma implementação do Model Context Protocol (MCP) que conecta o QGIS Desktop a grandes modelos de linguagem (LLMs), como o Claude. Utilizando um servidor baseado em socket e o plugin QGIS MCP, ele permite que assistentes de IA controlem e interajam diretamente com projetos do QGIS. Isso possibilita automação de tarefas orientadas por IA, como criação de projetos, manipulação de camadas, execução de algoritmos via Processing Toolbox e até execução direta de código Python dentro do QGIS. O servidor foi projetado para otimizar fluxos de trabalho geoespaciais, facilitar o processamento avançado de dados e aumentar a produtividade de desenvolvedores, permitindo uma gestão eficiente e orientada por prompts do QGIS a partir de um cliente LLM.

Lista de Prompts

Nenhum template de prompt explícito é mencionado no repositório.

Lista de Recursos

Nenhum recurso MCP explícito é descrito no repositório.

Lista de Ferramentas

• Manipulação de Projetos: Permite criar, carregar e salvar projetos QGIS via comandos LLM.
• Manipulação de Camadas: Possibilita adicionar ou remover camadas vetoriais e raster em um projeto QGIS.
• Execução de Processamentos: Executa algoritmos de processamento do QGIS (Processing Toolbox) via interface LLM.
• Execução de Código: Executa código Python arbitrário dentro do ambiente QGIS via solicitações LLM. (Altamente poderoso, use com cautela.)

Casos de Uso deste Servidor MCP

• Criação Automatizada de Projetos: Desenvolvedores e cientistas de dados podem usar LLMs para automatizar a configuração de novos projetos QGIS, garantindo estrutura e configuração consistentes.
• Gerenciamento de Camadas de Dados Geoespaciais: LLMs podem programaticamente adicionar, remover ou atualizar camadas vetoriais e raster, otimizando ingestão e visualização de dados.
• Processamento em Lote via Algoritmos: Assistentes de IA podem acionar algoritmos complexos do Processing Toolbox do QGIS em grandes conjuntos de dados, economizando tempo e reduzindo intervenção manual.
• Execução Remota de Código: Usuários podem enviar scripts Python para serem executados no QGIS, viabilizando análises customizadas, transformações de dados ou desenvolvimento de plugins.
• Análise Geoespacial Assistida por IA: Ao expor funções do QGIS a LLMs, consultas espaciais avançadas e operações de mapa podem ser realizadas conversacionalmente ou por agentes de IA.

Como configurar

Windsurf

Nenhuma instrução de configuração encontrada para Windsurf.

Claude

1. Pré-requisitos: Garanta que o QGIS 3.X (testado na 3.22), Python 3.10+ e o gerenciador de pacotes uv estejam instalados.
2. Baixe o Repositório:

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

3. Instale o Plugin QGIS:
   • Copie a pasta qgis_mcp_plugin para a pasta de plugins do seu perfil do QGIS (veja README.md para localizações específicas de cada plataforma).
   • Reinicie o QGIS e ative o plugin “QGIS MCP”.
4. Edite a Configuração do Claude:
   • Vá em Claude > Settings > Developer > Edit Config > claude_desktop_config.json.
   • Adicione o seguinte sob mcpServers:

     {
       "mcpServers": {
         "qgis": {
           "command": "uv",
           "args": [
             "--directory",
             "/CAMINHO/ABSOLUTO/PARA/PASTA/DO/REPO/qgis_mcp/src/qgis_mcp",
             "run",
             "qgis_mcp_server.py"
           ]
         }
       }
     }
     

5. Salve e Reinicie o Claude para aplicar a configuração.

Segurança de Chaves de API

Nenhum uso de chaves de API ou variáveis de ambiente para chaves é descrito no repositório.

Cursor

Nenhuma instrução de configuração encontrada para Cursor.

Cline

Nenhuma instrução de configuração encontrada para Cline.

Como usar este MCP em fluxos

Usando MCP no FlowHunt

Para integrar servidores MCP ao seu fluxo no FlowHunt, comece adicionando o componente MCP ao fluxo e conectando-o ao seu agente de IA:

Clique no componente MCP para abrir o painel de configuração. Na seção de configuração do sistema MCP, insira os detalhes do seu servidor MCP usando este formato JSON:

{
  "qgis": {
    "transport": "streamable_http",
    "url": "https://seumcpserver.exemplo/pathtothemcp/url"
  }
}

Uma vez configurado, o agente de IA estará apto a usar este MCP como ferramenta, com acesso a todas as suas funções e capacidades. Lembre-se de trocar “qgis” pelo nome real do seu servidor MCP e substituir a URL pela URL do seu MCP.

Visão Geral

Entre as duas tabelas, o Servidor QGIS MCP é bem documentado em termos de recursos principais e exposição de ferramentas, mas carece de listagens explícitas de prompts/recursos e não aborda segurança de chaves de API ou suporte a amostragem/roots. Eu daria uma nota de 6/10 para completude MCP e prontidão para desenvolvedores.

Pontuação MCP