MCP-Geo

What is MCP-Geo?

MCP-Geo is a geocoding MCP server built with GeoPy. It provides tools that allow Large Language Models (LLMs) to geocode addresses, reverse geocode coordinates, calculate distances, and perform batch lookups in a rate-limited, error-handled way. It is aimed at developers integrating location capabilities into AI workflows via Claude Desktop or other MCP clients.

How to use MCP-Geo?

Clone the repository, install dependencies with uv sync, then install the server using fastmcp install geo.py --name "MCP Geo" for Claude Desktop. For other environments, add the JSON configuration (with command: "uv", args: ["--directory", "MCP-Geo", "run", "geo.py"]) to your MCP settings file, optionally setting environment variables like GEOCODER_PROVIDER, NOMINATIM_URL, or API keys for alternative providers.

Key features of MCP-Geo

• Geocode a single address to latitude, longitude, and formatted address.
• Reverse geocode a latitude/longitude pair to the nearest address.
• Geocode with additional details like bounding boxes (provider-dependent).
• Batch geocode multiple addresses with rate limiting.
• Batch reverse geocode multiple coordinate pairs.
• Calculate distance between two addresses or coordinate pairs in miles/kilometers.

Use cases of MCP-Geo

• Convert a user‑provided place name into map coordinates for display or analysis.
• Find the street address corresponding to a GPS coordinate from a photo or sensor.
• Enrich location data by geocoding a list of addresses in one request.
• Calculate the distance between two addresses (e.g., for logistics or travel planning).

FAQ from MCP-Geo

What are the system requirements?

Python 3.6 or higher is required.

What dependencies are needed?

The server requires fastmcp (for the MCP framework) and geoPy (for geocoding). All dependencies are listed in requirements.txt and can be installed via uv sync.

How do I install MCP-Geo for Claude Desktop?

Run fastmcp install geo.py --name "MCP Geo" after cloning the repository and installing dependencies.

How can I switch the geocoding provider?

Set the GEOCODER_PROVIDER environment variable to "nominatim", "arcgis", or "bing". Additional variables (e.g., ARC_USERNAME, ARC_PASSWORD, BING_API_KEY, NOMINATIM_URL, SCHEME) can be configured in the MCP settings file or shell environment.

What safety features does MCP-Geo include?

Rate limiting (default 1‑second delay per geocoding call) prevents hitting service quotas, and error handling catches geopy exceptions, returning None instead of crashing.