gis-mcp

gis-mcp

A Model Context Protocol (MCP) server implementation that connects Large Language Models (LLMs) to GIS operations using GIS libraries, enabling AI assistants to perform geospatial operations and transformations.

Stars: 53

Visit
 screenshot

This repository contains a Geographic Information System (GIS) tool for performing Minimum Cumulative Path (MCP) analysis. The tool allows users to calculate the optimal path that minimizes cumulative cost between multiple locations on a map. It is particularly useful for urban planning, transportation route optimization, and environmental impact assessment. The tool supports various cost functions such as distance, travel time, and resource consumption, providing flexibility for different applications. Users can visualize the results on interactive maps and export the analysis outputs for further processing. The tool is implemented in Python and leverages popular GIS libraries such as GeoPandas and NetworkX for efficient spatial analysis.

README:

GIS MCP Server

โœจ Want to perform accurate geospatial analysis in your chatbot? โœจ

Install GIS-MCP and transform your AI's spatial capabilities!


GIS MCP Server Logo

A Model Context Protocol (MCP) server implementation that connects Large Language Models (LLMs) to GIS operations using GIS libraries, enabling AI assistants to perform geospatial operations and transformations.

๐ŸŒ Website: gis-mcp.com

Current version is 0.8.0

Version 0.9.0 (Beta) is under active development. We welcome contributions and developers to join us in building this project.

๐ŸŽฅ Demo

GIS MCP Server Demo

Rasterio Demo


Click to watch the Rasterio demo video or go to docs folder

๐Ÿ“‹ Table of Contents

๐Ÿš€ Features

GIS MCP Server empowers AI assistants with advanced geospatial intelligence. Key features include:

  • ๐Ÿ”น Comprehensive Geometry Operations โ€“ Perform intersection, union, buffer, difference, and other geometric transformations with ease.
  • ๐Ÿ”น Advanced Coordinate Transformations โ€“ Effortlessly reproject and transform geometries between coordinate reference systems.
  • ๐Ÿ”น Accurate Measurements โ€“ Compute distances, areas, lengths, and centroids precisely.
  • ๐Ÿ”น Spatial Analysis & Validation โ€“ Validate geometries, run proximity checks, and perform spatial overlays or joins.
  • ๐Ÿ”น Raster & Vector Support โ€“ Process raster layers, compute indices like NDVI, clip, resample, and merge with vector data.
  • ๐Ÿ”น Spatial Statistics & Modeling โ€“ Leverage PySAL for spatial autocorrelation, clustering, and neighborhood analysis.
  • ๐Ÿ”น Easy Integration โ€“ Connect seamlessly with MCP-compatible clients like Claude Desktop or Cursor IDE.
  • ๐Ÿ”น Flexible & Extensible โ€“ Supports Python-based GIS libraries and is ready for custom tools or workflow extensions.

๐ŸŒŸ Tip: With GIS MCP Server, your AI can now โ€œthink spatially,โ€ unlocking new capabilities for environmental analysis, mapping, and location intelligence.


๐Ÿ“‹ Prerequisites

  • Python 3.10 or higher
  • MCP-compatible client (like Claude Desktop or Cursor)
  • Internet connection for package installation

๐Ÿ›  Installation

Choose the installation method that best suits your needs:

๐Ÿ›  Installing via Smithery

To install GIS MCP Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @mahdin75/gis-mcp --client claude

๐Ÿ“ฆ pip Installation

The pip installation is recommended for most users:

  1. Install uv package manager:
pip install uv
  1. Create the Virtual Environment (Python 3.10+):
uv venv --python=3.10
  1. Install the package:
uv pip install gis-mcp
  1. Start the server:
gis-mcp

pip Configuration

To use the pip installation with Claude or Cursor, add the following configuration:

Claude Desktop:

Windows:

{
  "mcpServers": {
    "gis-mcp": {
      "command": "C:\\Users\\YourUsername\\.venv\\Scripts\\gis-mcp",
      "args": []
    }
  }
}

Linux/Mac:

{
  "mcpServers": {
    "gis-mcp": {
      "command": "/home/YourUsername/.venv/bin/gis-mcp",
      "args": []
    }
  }
}

Cursor IDE (create .cursor/mcp.json):

Windows:

{
  "mcpServers": {
    "gis-mcp": {
      "command": "C:\\Users\\YourUsername\\.venv\\Scripts\\gis-mcp",
      "args": []
    }
  }
}

Linux/Mac:

{
  "mcpServers": {
    "gis-mcp": {
      "command": "/home/YourUsername/.venv/bin/gis-mcp",
      "args": []
    }
  }
}

After configuration:

  1. Make sure to replace YourUsername with your actual username
  2. For development installation, replace /path/to/gis-mcp with the actual path to your project
  3. Restart your IDE to apply the changes
  4. You can now use all GIS operations through Claude or Cursor!

๐Ÿ›  Development Installation

For contributors and developers:

  1. Install uv package manager:
pip install uv
  1. Create the Virtual Environment:
uv venv --python=3.10
  1. Install the package in development mode:
uv pip install -e .
  1. Start the server:
python -m gis_mcp

Development Configuration

To use the development installation with Claude or Cursor, add the following configuration:

Claude Desktop:

Windows:

{
  "mcpServers": {
    "gis-mcp": {
      "command": "C:\\path\\to\\gis-mcp\\.venv\\Scripts\\python",
      "args": ["-m", "gis_mcp"]
    }
  }
}

Linux/Mac:

{
  "mcpServers": {
    "gis-mcp": {
      "command": "/path/to/gis-mcp/.venv/bin/python",
      "args": ["-m", "gis_mcp"]
    }
  }
}

Cursor IDE (create .cursor/mcp.json):

Windows:

{
  "mcpServers": {
    "gis-mcp": {
      "command": "C:\\path\\to\\gis-mcp\\.venv\\Scripts\\python",
      "args": ["-m", "gis_mcp"]
    }
  }
}

Linux/Mac:

{
  "mcpServers": {
    "gis-mcp": {
      "command": "/path/to/gis-mcp/.venv/bin/python",
      "args": ["-m", "gis_mcp"]
    }
  }
}

After configuration:

  1. Make sure to replace YourUsername with your actual username
  2. For development installation, replace /path/to/gis-mcp with the actual path to your project
  3. Restart your IDE to apply the changes
  4. You can now use all GIS operations through Claude or Cursor!

๐Ÿ“š Available Functions

This section provides a comprehensive list of all available functions organized by library.

๐Ÿ”ท Shapely Functions (29 total)

Basic Geometric Operations:

  • buffer - Create buffer around geometry
  • intersection - Find intersection of two geometries
  • union - Combine two geometries
  • difference - Find difference between geometries
  • symmetric_difference - Find symmetric difference

Geometric Properties:

  • convex_hull - Calculate convex hull
  • envelope - Get bounding box
  • minimum_rotated_rectangle - Get minimum rotated rectangle
  • get_centroid - Get centroid point
  • get_bounds - Get geometry bounds
  • get_coordinates - Extract coordinate array
  • get_geometry_type - Get geometry type name

Transformations:

  • rotate_geometry - Rotate geometry by angle
  • scale_geometry - Scale geometry by factors
  • translate_geometry - Move geometry by offset

Advanced Operations:

  • triangulate_geometry - Create triangulation
  • voronoi - Create Voronoi diagram
  • unary_union_geometries - Union multiple geometries

Measurements:

  • get_length - Calculate geometry length
  • get_area - Calculate geometry area

Validation & Utilities:

  • is_valid - Check geometry validity
  • make_valid - Fix invalid geometry
  • simplify - Simplify geometry
  • snap_geometry - Snap to reference geometry
  • nearest_point_on_geometry - Find nearest point
  • normalize_geometry - Normalize orientation
  • geometry_to_geojson - Convert to GeoJSON
  • geojson_to_geometry - Convert from GeoJSON

๐Ÿ”ท PyProj Functions (13 total)

Coordinate Transformations:

  • transform_coordinates - Transform point coordinates
  • project_geometry - Project geometry between CRS

CRS Information:

  • get_crs_info - Get detailed CRS information
  • get_available_crs - List available CRS systems
  • get_utm_zone - Get UTM zone for coordinates
  • get_utm_crs - Get UTM CRS for coordinates
  • get_geocentric_crs - Get geocentric CRS

Geodetic Calculations:

  • get_geod_info - Get ellipsoid information
  • calculate_geodetic_distance - Calculate distance on ellipsoid
  • calculate_geodetic_point - Calculate point at distance/azimuth
  • calculate_geodetic_area - Calculate area on ellipsoid

๐Ÿ”ท GeoPandas Functions (13 total)

I/O Operations:

  • read_file_gpd - Read geospatial file with preview
  • write_file_gpd - Export GeoDataFrame to file

Join & Merge Operations:

  • append_gpd - Concatenate GeoDataFrames vertically
  • merge_gpd - Database-style attribute joins
  • overlay_gpd - Spatial overlay operations
  • dissolve_gpd - Dissolve by attribute
  • explode_gpd - Split multi-part geometries

Spatial Operations:

  • clip_vector - Clip geometries
  • sjoin_gpd - Spatial joins
  • sjoin_nearest_gpd - Nearest neighbor spatial joins
  • point_in_polygon - Point-in-polygon tests

๐Ÿ”ท Rasterio Functions (20 total)

Basic Raster Operations:

  • metadata_raster - Get raster metadata
  • get_raster_crs - Get raster CRS
  • extract_band - Extract single band
  • raster_band_statistics - Calculate band statistics
  • raster_histogram - Compute pixel histograms

Raster Processing:

  • clip_raster_with_shapefile - Clip raster with polygons
  • resample_raster - Resample by scale factor
  • reproject_raster - Reproject to new CRS
  • tile_raster - Split into tiles

Raster Analysis:

  • compute_ndvi - Calculate vegetation index
  • raster_algebra - Mathematical operations on bands
  • concat_bands - Combine single-band rasters
  • weighted_band_sum - Weighted band combination

Advanced Analysis:

  • zonal_statistics - Statistics within polygons
  • reclassify_raster - Reclassify pixel values
  • focal_statistics - Moving window statistics
  • hillshade - Generate hillshade from DEM
  • write_raster - Write array to raster file

๐Ÿ”ท PySAL Functions (15 total)

Spatial Autocorrelation:

  • morans_i - Global Moran's I statistic
  • gearys_c - Global Geary's C statistic
  • gamma_statistic - Gamma index
  • getis_ord_g - Global Getis-Ord G statistic

Local Statistics:

  • moran_local - Local Moran's I
  • getis_ord_g_local - Local Getis-Ord G*
  • join_counts_local - Local join counts

Global Statistics:

  • join_counts - Binary join counts test
  • adbscan - Adaptive density-based clustering

Spatial Weights:

  • weights_from_shapefile - Create weights from shapefile
  • distance_band_weights - Distance-based weights
  • knn_weights - K-nearest neighbors weights
  • build_transform_and_save_weights - Build, transform, and save weights
  • ols_with_spatial_diagnostics_safe - OLS regression with spatial diagnostics
  • build_and_transform_weights - Build and transform weights

๐Ÿ”ท Administrative Boundaries Functions (1 total)

Boundary Download:

  • download_boundaries - Download GADM administrative boundaries and save as GeoJSON

๐Ÿ”ท Climate Data Functions (1 total)

Climate Data Download:

  • download_climate_data - Download climate data (ERA5 or other CDS datasets)

๐Ÿ”ท Ecology Data Functions (2 total)

Ecology Data Download and Info:

  • get_species_info โ€“ Retrieve taxonomic information for a given species name
  • download_species_occurrences โ€“ Download occurrence records for a given species and save as JSON

๐Ÿ”ท Movement Data Functions (2 total)

Movement Data Download and Routing (via OSMnx):

  • download_street_network โ€“ Download a street network for a given place and save as GraphML
  • calculate_shortest_path โ€“ Calculate the shortest path between two points using a saved street network

๐Ÿ”ท Land Cover Data Functions (2 total)

Land Cover from Planetary Computer:

  • download_worldcover โ€“ Download ESA WorldCover for AOI/year; optional crop and reprojection
  • compute_s2_ndvi โ€“ Compute NDVI from Sentinel-2 L2A; crop and reprojection supported

๐Ÿ”ท Satellite Imagery Functions (1 total)

STAC-based Satellite Download:

  • download_satellite_imagery โ€“ Download and stack bands from STAC items (e.g., Sentinel-2, Landsat), with optional crop and reprojection

Total Functions Available: 89

๐Ÿ›  Client Development

Example usage of the tools:

Buffer Operation

Tool: buffer
Parameters: {
    "geometry": "POINT(0 0)",
    "distance": 10,
    "resolution": 16,
    "join_style": 1,
    "mitre_limit": 5.0,
    "single_sided": false
}

Coordinate Transformation

Tool: transform_coordinates
Parameters: {
    "coordinates": [0, 0],
    "source_crs": "EPSG:4326",
    "target_crs": "EPSG:3857"
}

Geodetic Distance

Tool: calculate_geodetic_distance
Parameters: {
    "point1": [0, 0],
    "point2": [10, 10],
    "ellps": "WGS84"
}

๐Ÿ”ฎ Planned Features

  • Implement advanced spatial indexing
  • Implement network analysis capabilities
  • Add support for 3D geometries
  • Implement performance optimizations
  • Add support for more GIS libraries

๐Ÿค Contributing

We welcome contributions! Here's how you can help:

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

Please ensure your PR description clearly describes the problem and solution. Include the relevant issue number if applicable.

๐Ÿ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.

๐Ÿ”— Related Projects

Project Name Category Description
Model Context Protocol MCP Related The core MCP implementation
Shapely Geospatial Analysis Python package for manipulation and analysis of geometric objects
PyProj Geospatial Analysis Python interface to PROJ library
GeoPandas Geospatial Analysis Python package for working with geospatial data
Rasterio Geospatial Analysis Python package for reading and writing geospatial raster data
PySAL Geospatial Analysis Python spatial analysis library for geospatial data science
cdsapi Geospatial Data Collecting Python API to access the Copernicus Climate Data Store (CDS)
pygadm Geospatial Data Collecting Easy access to administrative boundary defined by GADM from Python scripts
pygbif Geospatial Data Collecting Python client for the GBIF API (ecology and biodiversity data)
OSMnx Geospatial Data Collecting Python package for downloading, modeling, and analyzing street networks and urban features from OpenStreetMap
pystac-client Geospatial Data Collecting Python client for STAC catalogs; search and access spatiotemporal assets
Planetary Computer SDK for Python Geospatial Data Collecting Python SDK for Microsoft Planetary Computer; auth and helpers for STAC/COGs

๐Ÿ“ž Support

For support, please open an issue in the GitHub repository.

๐Ÿ’ฌ Community

Join our Discord community for discussions, updates, and support:

Join our Discord

๐Ÿ‘ฅ Contributors

Made with contrib.rocks.


๐Ÿ† Badges

Trust Score

GIS Server MCP server


MCP.so Badge

For Tasks:

Click tags to check more tools for each tasks

For Jobs:

Alternative AI tools for gis-mcp

Similar Open Source Tools

For similar tasks

For similar jobs