LocuSync Server

Provides geospatial tools via MCP for geocoding, routing, elevation, spatial analysis, and file I/O.

python

GitHub Stars

python

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "matbel91765-gis-mcp-server": {
      "command": "uvx",
      "args": [
        "locusync-server"
      ],
      "env": {
        "OSRM_URL": "https://router.project-osrm.org",
        "PELIAS_URL": "https://pelias.example/api",
        "GIS_TEMP_DIR": "/tmp/locusync",
        "OSRM_PROFILE": "driving",
        "NOMINATIM_URL": "https://nominatim.openstreetmap.org",
        "PELIAS_API_KEY": "YOUR_API_KEY",
        "GIS_DEFAULT_CRS": "EPSG:4326",
        "OPEN_ELEVATION_URL": "https://api.open-elevation.com",
        "NOMINATIM_USER_AGENT": "locusync-server/1.0.0"
      }
    }
  }
}

LocuSync Server is a Model Context Protocol (MCP) server that adds geospatial capabilities to your AI agents. It lets you perform geocoding, routing, spatial analysis, and file I/O directly from your MCP-enabled tools, enabling smarter location-aware decisions in your applications.

How to use

To use LocuSync Server with an MCP client, run the server locally or connect to it via an MCP launcher that supports stdio-based execution. You can start the server directly from your command line or integrate it into your client workflow using a launcher that runs the server binary. Once running, your MCP client can invoke geocoding, routing, elevation, spatial analysis, and file operations through the server’s tools.

How to install

Prerequisites: you need Python and a modern package manager installed on your machine.

Install from source

git clone https://github.com/matbel91765/locusync-server.git
cd locusync-server
pip install -e .

Run the server directly

Start the MCP server from the command line using the server executable.

Run via a launcher (stdio)

uvx locusync-server

Run the MCP server directly (alternative)

locusync-server

Available tools

geocode

Convert an address to geographic coordinates, returning latitude, longitude, and a display name.

reverse_geocode

Resolve coordinates back to a human-readable address or place name.

batch_geocode

Geocode multiple addresses in a single request, up to a specified limit.

get_elevation

Retrieve the altitude for a single point.

get_elevation_profile

Generate elevation data along a path between two points.

route

Compute a routing solution between two points including distance, duration, and route geometry.

isochrone

Produce an area reachable within a time or distance constraint from a location.

buffer

Create a buffer geometry around a given shape and measure its area.

distance

Calculate the distance between two geographic points.

transform_crs

Transform coordinates between coordinate reference systems.

read_file

Read geospatial files such as Shapefile, GeoJSON, or GeoPackage into a standard feature collection.

write_file

Write a set of features to a geospatial file format like GeoJSON or Shapefile.

Built by

VeilStrat

AI signals for GTM teams