qgis
Geospatial analysis and GIS operations via QGIS. Use for calculating distances, buffering zones, coordinate transforms (EPSG:4326 to EPSG:3857), layer operations, geoprocessing (intersect, union, clip), and exporting map images. Requires QGIS running on Display :1 with MCP plugin enabled.
When & Why to Use This Skill
The QGIS Claude skill empowers users to perform professional-grade geospatial analysis and GIS operations directly within the Claude interface. By leveraging the FastMCP protocol to communicate with a QGIS instance, this tool facilitates complex spatial tasks such as coordinate system transformations (e.g., EPSG:4326 to EPSG:3857), buffer zone creation, and advanced geoprocessing (intersect, union, clip). It is an essential utility for researchers, urban planners, and data analysts who need to manipulate Shapefile, GeoJSON, or GeoPackage layers and export high-quality map visualizations for data-driven reports.
Use Cases
- Urban Planning & Zoning: Create precise buffer zones around infrastructure projects to analyze environmental impact and proximity to residential areas.
- Logistics & Supply Chain Optimization: Calculate geographic distances and perform coordinate transformations to optimize delivery routes and warehouse locations.
- Environmental Research: Execute geoprocessing operations such as 'intersect' or 'union' on multiple spatial layers to identify land-use changes or habitat overlaps.
- Real Estate Intelligence: Query and filter geospatial features within specific layers to identify properties that meet complex spatial and attribute criteria.
- Automated Cartography: Generate and export styled map images (PNG, JPG, PDF) for technical reports and presentations using categorized or graduated symbology.
| name | qgis |
|---|---|
| description | > |
| buffering zones, coordinate transforms (EPSG | 4326 to EPSG:3857), layer operations, |
| running on Display | 1 with MCP plugin enabled. |
| version | 2.0.0 |
| author | turbo-flow-claude |
| mcp_server | true |
| protocol | fastmcp |
| entry_point | mcp-server/server.py |
| port | 9877 |
QGIS Skill
Geospatial analysis and GIS operations via FastMCP protocol, communicating with QGIS instance via TCP socket.
When to Use This Skill
- Calculate distances between geographic points
- Create buffer zones around features (proximity analysis)
- Transform coordinates between CRS (GPS to Web Mercator)
- Load and manipulate geospatial layers (Shapefile, GeoJSON, GeoPackage)
- Perform geoprocessing operations (intersect, union, difference, clip)
- Export map images for reports or web display
- Query features with spatial filters
- Style layers with categorized or graduated symbology
Architecture
┌─────────────────────────────┐
│ Claude Code / VisionFlow │
│ (MCP Client) │
└──────────────┬──────────────┘
│ MCP Protocol (stdio)
▼
┌─────────────────────────────┐
│ QGIS MCP Server (FastMCP) │
│ Port: stdio │
└──────────────┬──────────────┘
│ TCP Socket
▼
┌─────────────────────────────┐
│ QGIS Desktop (Display :1) │
│ MCP Plugin on Port 9877 │
└─────────────────────────────┘
Tools
| Tool | Description |
|---|---|
load_layer |
Load geospatial layer (Shapefile, GeoJSON, GeoPackage, WMS) |
buffer_analysis |
Create buffer zones around features |
calculate_distance |
Calculate distance between two points |
transform_coordinates |
Transform between coordinate systems |
export_map |
Export map view as PNG, JPG, or PDF |
query_features |
Query layer features with filter expression |
list_layers |
List all loaded layers |
set_layer_style |
Apply styling (simple, categorized, graduated) |
geoprocessing |
Intersect, union, difference, dissolve, clip |
get_layer_extent |
Get bounding box of a layer |
health_check |
Verify QGIS connection |
Examples
# Load a GeoJSON layer
load_layer({
"path": "/data/cities.geojson",
"name": "Cities"
})
# Create 10km buffer around points
buffer_analysis({
"layer_name": "Cities",
"distance": 10000, # meters
"output_name": "city_buffers"
})
# Transform GPS coordinates to Web Mercator
transform_coordinates({
"coordinates": [-122.4194, 37.7749], # San Francisco
"source_crs": "EPSG:4326",
"target_crs": "EPSG:3857"
})
# Export map image
export_map({
"output_path": "/output/map.png",
"width": 1920,
"height": 1080,
"dpi": 150
})
Environment Variables
| Variable | Default | Description |
|---|---|---|
QGIS_HOST |
localhost |
QGIS MCP plugin host |
QGIS_PORT |
9877 |
QGIS MCP plugin port |
QGIS_TIMEOUT |
60 |
Socket timeout in seconds |
Troubleshooting
Connection refused:
# Check QGIS is running on Display :1
supervisorctl status qgis
# Verify MCP plugin is loaded
# In QGIS: Plugins → Manage Plugins → Search "MCP"
VisionFlow Integration
This skill exposes qgis://capabilities and qgis://status resources for discovery by VisionFlow's MCP TCP client.