dcc-mcp-qgis

Status: hardened pre-release candidate, not a production-release claim. This candidate pins Core/server 0.20.41 and requires native revalidation. Historical native acceptance used Linux QGIS 3.40.6, Qt 5.15.15, Python 3.13.5 and Core/server 0.20.39; those results do not qualify this upgrade. See the runtime upgrade and release gates.

Typed QGIS project and vector editing over MCP. This adapter owns a new headless PyQGIS process and an isolated project. It does not attach to or alter a running QGIS desktop session.

Quick start

Use the Python supplied with QGIS. On a Linux distribution with python3-qgis already installed:

/usr/bin/python3 -m venv --system-site-packages .venv
.venv/bin/python -m pip install -e '.[dev]'
QT_QPA_PLATFORM=offscreen .venv/bin/dcc-mcp-qgis --workspace ./gis-work --endpoint-file ./endpoint.json

Runtime startup rejects QGIS outside 3.40.x, Qt6, non-Linux hosts, Python outside 3.10–3.13 and Core/server versions other than 0.20.41. Admitted version ranges are not a claim that every combination has passed native acceptance.

The default port is selected by the OS; --port or DCC_MCP_QGIS_PORT may override it. Use mcp_url from the endpoint file; the safe default disables the optional gateway and its registry enrollment. The endpoint is loopback-only and intended for a trusted local operator.

Load qgis-project and qgis-vector with Core load_skill. Query IDs before editing. All requests are limited to 1 MiB of JSON arguments; geometry coordinates to ±1e9 CRS units. All geometry is bounded, 2D WKT with an explicit EPSG CRS. Typed fields support string, integer, number, and boolean values. Tools create/query/edit vectors, export GeoJSON/GeoPackage, save/reopen editable QGZ bundles, and render PNG maps.

All GIS paths are relative to the configured workspace. Absolute paths, parent traversal, symlinks, remote sources, and output replacement are refused. Save to a new directory; reopening accepts adapter-created bundles only. The saved QGZ and GeoPackages can also be opened normally in QGIS Desktop.

Read installation, architecture, and validation. No PyPI package or GitHub release is claimed by this source tree.