webcoderz/MCP-Geo
Free用于 nominatim, ArcGIS, Bing 的地理编码 MCP 服务器。
FreeFree tier
About webcoderz/MCP-Geo
MCP-Geo is a geocoding Model Context Protocol (MCP) server built with GeoPy, providing a set of tools for Large Language Models to perform geocoding and reverse geocoding. It supports multiple geocoding providers (e.g., Nominatim, ArcGIS, Bing) and includes features such as address lookup, detailed geocoding, batch operations, and distance calculations between addresses or coordinates. The server implements rate limiting and error handling to ensure reliable operation.
Key Features
Geocode location: convert address to latitude, longitude, and formatted address
Reverse geocode: convert latitude/longitude to nearest address
Geocode with details: returns bounding boxes and additional address info
Batch geocoding: process multiple addresses with rate limiting
Batch reverse geocoding: process multiple coordinate pairs
Distance calculation between two addresses or coordinate pairs (miles/kilometers)
Rate limiting to prevent hitting geocoding service quotas
Error handling: catches exceptions and returns None instead of crashing
Pros & Cons
Pros
- Open source and free to use
- Supports multiple geocoding providers via GeoPy (Nominatim, ArcGIS, Bing, etc.)
- Provides a comprehensive set of geocoding tools beyond simple lookup
- Includes rate limiting and error handling for production use
- Easy to install and configure with Claude Desktop or any MCP client
Cons
- Requires external geocoding service access (may have usage limits or require API keys)
- Default provider is Nominatim, which has usage restrictions without a custom instance
- Only supports Python 3.6+
- Limited documentation on provider configuration beyond Nominatim
Best For
Add geocoding capabilities to AI assistants and chatbotsConvert place names to coordinates for mapping applicationsFind addresses from GPS coordinatesCalculate distances between locations for logistics or travel planningBatch geocode address lists for data enrichment
FAQ
What is MCP-Geo?
MCP-Geo is a geocoding server built for the Model Context Protocol (MCP). It uses GeoPy to provide geocoding, reverse geocoding, batch lookups, and distance calculations to Large Language Models.
How do I install MCP-Geo?
Clone the repository, run 'uv sync' to install dependencies, then use 'fastmcp install geo.py --name "MCP Geo"' for Claude Desktop or configure the server manually in your MCP settings.
What geocoding providers are supported?
The server uses GeoPy, which supports many providers including Nominatim, ArcGIS, Bing, Google, and others. The provider can be set via the GEOCODER_PROVIDER environment variable.
Does it include rate limiting?
Yes, each geocoding call includes a 1-second delay to avoid excessive requests and respect service quotas.