Geo

🚀 MCP-Geo

A MCP server for geocoding and reverse geocoding using GeoPY!

🚀 Quick Start

1. Clone the repository:

git clone [your-repository-url]
cd mcp-geo

2. Install dependencies:

pip install -r requirements.txt

3. Start the server:

python geo.py

✨ Features

This MCP server provides the following geocoding and reverse geocoding tools for large language models (LLMs):

geocode_location

• Accepts an address or place name provided by the user and returns the best-matching latitude, longitude, and formatted address.
• Handles errors flexibly without the need to specify latitude and longitude parameters.

reverse_geocode

• Returns geographical location information based on latitude and longitude coordinates.

geocode_batch

• Batch geocoding and reverse geocoding function, supporting the processing of multiple addresses or latitudes and longitudes.

📦 Installation

System Requirements

• Python 3.6+

Dependencies

Install all the necessary dependencies:

# Use uv
uv sync

Required Packages

• fastmcp: A framework for building Model Context Protocol servers.
• geoPy: A Python library for accessing and geocoding/reverse geocoding geographical locations.

All dependencies are listed in requirements.txt for easy installation.

pip install -r requirements.txt

Project Structure

mcp-geo/
├── geo.py              # Main business logic file
├── config.py           # Configuration management module
└── requirements.txt    # Dependency management file

📚 Documentation

Table of Contents

• System Requirements
• Dependencies
• MCP Tools
• Getting Started
• Installation Options
  • Claude Desktop
  • Other Places
• Safety Features
• Development Documentation
• Environment Variables

Environment Variables

These can be set in your shell or configured in the MCP settings file for your environment.

If more customization is needed, edit geo.py and add the required variables according to the geocoder you are using.