qgis

pacphi's avatarfrom pacphi

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.

⭐8stars🔀1forks📁View on GitHub🕐Updated Dec 26, 2025

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.
nameqgis
description>
buffering zones, coordinate transforms (EPSG4326 to EPSG:3857), layer operations,
running on Display1 with MCP plugin enabled.
version2.0.0
authorturbo-flow-claude
mcp_servertrue
protocolfastmcp
entry_pointmcp-server/server.py
port9877

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.