qgis_mcp

Author: jjsantos01

Description: Model Context Protocol (MCP) server + QGIS plugin that lets LLMs (e.g. Claude) control a local QGIS Desktop session

Stars: 573

Forks: 72

License: Unknown – no license metadata present in the repository record

Category: Specialized

Overview

1. Install QGIS Desktop (v3.30 or newer recommended).

2. Install Python ≥3.9 (QGIS bundles its own Python but an external interpreter is useful for development).

3. Clone the repository:

git clone https://github.com/jjsantos01/qgis_mcp.git && cd qgis_mcp

4. (Optional) Create a virtual-environment and activate it:

python -m venv .venv
source .venv/bin/activate   # Windows: .venv\Scripts\activate

5. Install Python requirements:

pip install -r requirements.txt

6. Launch the MCP server:

python mcp_server.py --port 3333 # adjust script/port if README differs

7. Open QGIS and enable the “Python Console” or the included QGIS plugin (if provided) so that MCP can issue commands to the running QGIS instance.

8. Expose the service (optional):

# behind a reverse proxy
ssh -R 0.0.0.0:3333:localhost:3333 your-box

9. Test with curl or an LLM agent configured for Model Context Protocol:

curl http://localhost:3333/health

License: Unknown – no license metadata present in the repository record

Updated 7/30/2025