GIS MCP Server

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.

Alpha

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

🎥 Demo

Rasterio Demo

📋 Table of Contents

• Features
• Prerequisites
• Installation
  • pip Installation
  • Development Installation
• Available Tools
  • Shapely Operations
    • Basic Operations
    • Geometric Properties
    • Transformations
    • Advanced Operations
    • Measurements
    • Validation and Simplification
  • PyProj Operations
    • Coordinate Transformations
    • CRS Information
    • Geodetic Calculations
  • Geopandas Operations
    • I/O Operations
    • Join Operations
  • Rasterio Operations
    • Basic Raster Operations
    • Raster Processing
    • Raster Analysis
• Client Development
• Planned Features
• Contributing
• License
• Related Projects
• Support
• Badges

🚀 Features

• 🔍 Comprehensive geometric operations (intersection, union, buffer, etc.)
• 🌐 Advanced coordinate transformations and projections
• 📏 Precise distance and area calculations
• 🗺️ Spatial analysis and validation
• 🛠️ Easy integration with MCP-compatible clients

📋 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 Tools

Shapely Operations

Basic Operations

Tool	Description
buffer	Create a buffer around geometries with customizable parameters
intersection	Find intersection of two geometries
union	Combine two geometries
difference	Find difference between geometries
symmetric_difference	Find symmetric difference between geometries

Geometric Properties

Tool	Description
convex_hull	Calculate convex hull of a geometry
envelope	Get bounding box of a geometry
minimum_rotated_rectangle	Get minimum rotated rectangle of a geometry
get_centroid	Get the centroid of a geometry
get_bounds	Get the bounds of a geometry
get_coordinates	Get the coordinates of a geometry
get_geometry_type	Get the type of a geometry

Transformations

Tool	Description
rotate_geometry	Rotate a geometry with specified angle and origin
scale_geometry	Scale a geometry with x and y factors
translate_geometry	Translate a geometry with x, y, and z offsets

Advanced Operations

Tool	Description
triangulate_geometry	Create a triangulation of a geometry
voronoi	Create a Voronoi diagram from points
unary_union_geometries	Create a union of multiple geometries

Measurements

Tool	Description
get_length	Get the length of a geometry
get_area	Get the area of a geometry

Validation and Simplification

Tool	Description
is_valid	Check if a geometry is valid
make_valid	Make a geometry valid
simplify	Simplify a geometry with specified tolerance

PyProj Operations

Coordinate Transformations

Tool	Description
transform_coordinates	Transform coordinates between CRS
project_geometry	Project a geometry between CRS

CRS Information

Tool	Description
get_crs_info	Get detailed information about a CRS
get_available_crs	Get list of all available CRS
get_utm_zone	Get UTM zone for given coordinates
get_utm_crs	Get UTM CRS for given coordinates
get_geocentric_crs	Get geocentric CRS for given coordinates

Geodetic Calculations

Tool	Description
get_geod_info	Get information about a geodetic calculation
calculate_geodetic_distance	Calculate geodetic distance between points
calculate_geodetic_point	Calculate point at given distance and azimuth
calculate_geodetic_area	Calculate area of a polygon using geodetic calculations

GeoPandas Operations

I/O Operations

Tool	Description
read_file_gpd	Read a geospatial file and return stats and data preview
to_file_gpd	Write a GeoDataFrame to a file

Join Operations

Tool	Description
append_gpd	Concatenate two GeoDataFrames vertically
merge_gpd	Perform database-style joins between GeoDataFrames

Rasterio Operations

Basic Raster Operations

Tool	Description
metadata_raster	Get metadata from a raster dataset
get_raster_crs	Retrieve the CRS of a raster dataset
extract_band	Extract a specific band from a multi-band raster
raster_band_statistics	Calculate statistics (min, max, mean, std) for each band
raster_histogram	Compute histogram of pixel values for each band

Raster Processing

Tool	Description
clip_raster_with_shapefile	Clip a raster using polygons from a shapefile
resample_raster	Resample a raster by a scale factor
reproject_raster	Reproject a raster to a new CRS
tile_raster	Split a raster into square tiles

Raster Analysis

Tool	Description
compute_ndvi	Calculate Normalized Difference Vegetation Index
raster_algebra	Perform algebraic operations on raster bands
concat_bands	Combine multiple single-band rasters into one multi-band raster
weighted_band_sum	Compute weighted sum of all bands in a raster

🛠️ 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

• Add support for more GIS libraries - GDAL/OGR
• Implement advanced spatial indexing
• Add support for raster operations
• Implement network analysis capabilities
• Add support for 3D geometries
• Implement performance optimizations

🤝 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

• Model Context Protocol - The core MCP implementation
• Shapely - Python package for manipulation and analysis of geometric objects
• PyProj - Python interface to PROJ library
• GeoPandas - Python package for working with geospatial data
• Rasterio - Python package for reading and writing geospatial raster data

📞 Support

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

💬 Community

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

👥 Contributors

Made with contrib.rocks.

🏆 Badges