Advertise
MCP.so
Sign In

MCP Geo

@webcoderz

Repository

Basic information

Category

Other

License

MIT

Transports

stdio

Author

webcoderz

About MCP Geo

Geocoding MCP server with GeoPY!

#geocoding#geopy#mcp-server

MCP Geo config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "MCP-Geo": {
      "command": "uv",
      "args": [
        "pip",
        "install",
        "-r",
        "requirements.txt"
      ]
    }
  }
}

MCP Geo tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

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).

Frequently asked questions

1

What are the system requirements?

Python 3.6 or higher is required.

2

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`.

3

How do I install MCP-Geo for Claude Desktop?

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

4

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.

5

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.

Comments

More Other MCP servers

Awesome Mlops

visenger

A curated list of references for MLOps

14.0K

Activepieces

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

23.2K

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K

Codelf

unbug

A search tool helps dev to solve the naming things problem.

14.2K
N

Next Generation Movers: free moving quotes (remote MCP)

Next Generation Movers

Free moving quotes for AI agents from Next Generation Movers, a licensed interstate mover (USDOT 3764697). US long-distance nationwide and local DC/MD/VA. Indicative ballpark price and booking options; optional $0.01 x40

Advertise