Happy slice of mcp pizzaMCP.pizza

qgis_mcp

MCP.Pizza Chef: jjsantos01

QGIS is the free desktop mapping program used by planners, researchers and city offices, and this add-on lets Claude drive it directly. Once the plugin is running you can start or open a project, pull in map files, zoom around, run the built-in analysis steps, shade a map by a chosen column, and save a picture of the result. Nothing is paid and no key is needed, but installing it means downloading the code and copying a folder into QGIS by hand.

Data
Images/Design

Use This MCP server To

Load my map files into a fresh QGIS project Shade a map by population using five even bands Zoom to one layer and save the view as an image Run a built-in QGIS calculation and keep the output Ask which layers are currently in my project

README

QGISMCP - QGIS Model Context Protocol Integration

QGISMCP connects QGIS to Claude AI through the Model Context Protocol (MCP), allowing Claude to directly interact with and control QGIS. This integration enables prompt assisted project creation, layer loading, code execution and more.

This project is strongly based on the BlenderMCP project by Siddharth Ahuja

Features

  • Two-way communication: Connect Claude AI to QGIS through a socket-based server.
  • Project manipulation: Create, load and save projects in QGIS.
  • Layer manipulation: Add and remove vector or raster layers to a project.
  • Execute processing: Execute processing algorithms (Processing Toolbox).
  • Code execution: Run arbitrary Python code in QGIS from Claude. Very powerful, but also be very cautious using this tool.

Components

The system consists of two main components:

  1. QGIS plugin: A QGIS plugin that creates a socket server within QGIS to receive and execute commands.
  2. MCP Server: A Python server that implements the Model Context Protocol and connects to the QGIS plugin.

Installation

Prerequisites

  • QGIS 3.X (only tested on 3.22)
  • Claude desktop
  • Python 3.10 or newer
  • uv package manager:

If you're on Mac, please install uv as

brew install uv

On Windows Powershell

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Otherwise installation instructions are on their website: Install uv

⚠️ Do not proceed before installing UV

qgis_mcp FAQ

Which apps does this work in?
Claude Desktop, with QGIS 3 open on the same computer; the author has only tested QGIS 3.22.
Do I need a paid key?
No. Everything runs locally on your own machine with your own map files.
Can I use this to make a colour-coded map from one column of my data?
Yes — ask for a shaded map from that field and say how many bands and which colour range you want.
How hard is setup?
This is the involved end of the scale: download the code, copy a plugin folder into your QGIS profile, install the uv tool, paste a settings block, then start the server from the QGIS menu.
Is there anything to be careful about?
It can run arbitrary code inside QGIS, which is powerful but means you should only accept instructions you actually understand.
Does it work on Windows and Mac?
Yes, and Linux; the instructions list the plugin folder location for each.