GIS MCP Server

Integrations

  • Planned integration with GDAL/OGR for expanded GIS capabilities including raster operations and advanced spatial analysis.

  • Leverages Python GIS libraries (Shapely and PyProj) to provide geometric operations, coordinate transformations, and geodetic calculations for AI assistants.

GIS MCP Server

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

Alpha

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

🎥 Demo

📋 Table of Contents

🚀 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:

📦 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
ToolDescription
bufferCreate a buffer around geometries with customizable parameters
intersectionFind intersection of two geometries
unionCombine two geometries
differenceFind difference between geometries
symmetric_differenceFind symmetric difference between geometries
Geometric Properties
ToolDescription
convex_hullCalculate convex hull of a geometry
envelopeGet bounding box of a geometry
minimum_rotated_rectangleGet minimum rotated rectangle of a geometry
get_centroidGet the centroid of a geometry
get_boundsGet the bounds of a geometry
get_coordinatesGet the coordinates of a geometry
get_geometry_typeGet the type of a geometry
Transformations
ToolDescription
rotate_geometryRotate a geometry with specified angle and origin
scale_geometryScale a geometry with x and y factors
translate_geometryTranslate a geometry with x, y, and z offsets
Advanced Operations
ToolDescription
triangulate_geometryCreate a triangulation of a geometry
voronoiCreate a Voronoi diagram from points
unary_union_geometriesCreate a union of multiple geometries
Measurements
ToolDescription
get_lengthGet the length of a geometry
get_areaGet the area of a geometry
Validation and Simplification
ToolDescription
is_validCheck if a geometry is valid
make_validMake a geometry valid
simplifySimplify a geometry with specified tolerance

PyProj Operations

Coordinate Transformations
ToolDescription
transform_coordinatesTransform coordinates between CRS
project_geometryProject a geometry between CRS
CRS Information
ToolDescription
get_crs_infoGet detailed information about a CRS
get_available_crsGet list of all available CRS
get_utm_zoneGet UTM zone for given coordinates
get_utm_crsGet UTM CRS for given coordinates
get_geocentric_crsGet geocentric CRS for given coordinates
Geodetic Calculations
ToolDescription
get_geod_infoGet information about a geodetic calculation
calculate_geodetic_distanceCalculate geodetic distance between points
calculate_geodetic_pointCalculate point at given distance and azimuth
calculate_geodetic_areaCalculate area of a polygon using geodetic calculations

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

📞 Support

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

🏆 Badges

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

local-only server

The server can only run on the client's local machine because it depends on local resources.

A Model Context Protocol server that connects LLMs to GIS operations, enabling AI assistants to perform accurate geospatial analysis including geometric operations, coordinate transformations, and spatial measurements.

  1. 🎥 Demo
    1. 📋 Table of Contents
      1. 🚀 Features
        1. 📋 Prerequisites
          1. 🛠️ Installation
            1. 📦 pip Installation
            2. 🛠️ Development Installation
          2. 🛠️ Available Tools
            1. Shapely Operations
            2. PyProj Operations
          3. 🛠️ Client Development
            1. Buffer Operation
            2. Coordinate Transformation
            3. Geodetic Distance
          4. 🔮 Planned Features
            1. 🤝 Contributing
              1. 📄 License
                1. 🔗 Related Projects
                  1. 📞 Support
                    1. 🏆 Badges

                      Related MCP Servers

                      • A
                        security
                        A
                        license
                        A
                        quality
                        A Model Context Protocol server that provides LLM Agents with a comprehensive toolset for IP geolocation, network diagnostics, system monitoring, cryptographic operations, and QR code generation.
                        Last updated -
                        16
                        3
                        4
                        TypeScript
                        Apache 2.0
                      • A
                        security
                        A
                        license
                        A
                        quality
                        A Model Context Protocol server that provides basic mathematical and statistical functions to LLMs, enabling them to perform accurate numerical calculations through a simple API.
                        Last updated -
                        13
                        2
                        TypeScript
                        MIT License
                      • A
                        security
                        A
                        license
                        A
                        quality
                        A Model Context Protocol server that provides Google Maps API integration, allowing users to search locations, get place details, geocode addresses, calculate distances, obtain directions, and retrieve elevation data through LLM processing capabilities.
                        Last updated -
                        7
                        46
                        14
                        TypeScript
                        MIT License
                      • -
                        security
                        F
                        license
                        -
                        quality
                        A Model Context Protocol server that connects LLMs to the Compiler Explorer API, enabling them to compile code, explore compiler features, and analyze optimizations across different compilers and languages.
                        Last updated -
                        Python

                      View all related MCP servers

                      ID: irl5u9uw6f