Geocode

Provides latitude/longitude coordinates for cities and locations via the OpenStreetMap Nominatim API for MCP-enabled tools.

python

2

GitHub Stars

python

Language

5 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": {
    "x-mckay-geocode-mcp": {
      "command": "uvx",
      "args": [
        "geocode-mcp"
      ]
    }
  }
}

This MCP server provides geocoding capabilities by returning latitude and longitude coordinates for cities and places worldwide. It integrates with MCP-enabled tools to let you query locations and use the results directly in your workflows, automations, or editor environments without needing a separate geocoding client.

How to use

You can use this server with any MCP-compatible client to obtain coordinates for a location. Start a local MCP server or connect to a remote MCP endpoint, then call the coordinate tool from your MCP client. The server uses a reliable geocoding source to translate city names, addresses, or locations into latitude/longitude results that you can feed into maps, routing, or data enrichment tasks.

How to install

Prerequisites you need before installing are Python 3.12 or later and a working Python environment.

Step 1: Install the MCP geocoding package from your preferred installer.

uvx geocode-mcp

pip install geocode-mcp

Additional configuration and setup

Configure your MCP client to connect to the geocoding server. You have two common local configurations you can use to run the server from your development environment.

{
  "mcpServers": {
    "geocoding": {
      "command": "uvx",
      "args": ["geocode-mcp"]
    }
  }
}

{
  "mcpServers": {
    "geocoding": {
      "command": "python",
      "args": ["-m", "geocode_mcp.server"],
      "cwd": "/path/to/geocode-mcp",
      "env": {
        "PYTHONPATH": "/path/to/geocode-mcp/src"
      }
    }
  }
}

Notes on usage

The server exposes a single MCP tool that returns coordinates for a given location. You can request multiple results up to a limit, and you receive structured information including the latitude, longitude, and a display name for each result.

Available tools

mcp_geocoding_get_coordinates

Fetch latitude and longitude coordinates for a given location. Supports a limit on the number of results and returns structured data including the display name, coordinates, and location metadata.