@cyanheads/openstreetmap-mcp-server

maps-geo MCP Server

Access OpenStreetMap data, geocode locations, and run Overpass spatial queries through a Model Context Protocol server.

VerifiedInstall Ready
maps-geomaps-geo
3 views1 stars0 forksv0.2.4Apache-2.0

Why This Matters

Discovered via github-topic:model-context-protocol and last synced 1mo ago.

VerifiedInstall Ready
Source
github-topic:model-context-protocol
Stars
1
Last synced
1mo ago
Install
Instructions detected

Install

1. Install the package

npx @cyanheads/openstreetmap-mcp-server

2. Add to claude_desktop_config.json

{
  "mcpServers": {
    "cyanheads-openstreetmap-mcp-server": {
      "command": "npx",
      "args": [
        "@cyanheads/openstreetmap-mcp-server"
      ]
    }
  }
}

Config file location: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) / %APPDATA%\Claude\claude_desktop_config.json (Windows)

21
Tools
0
Resources
0
Prompts
Standard I/O
Transport

Available Tools (21)

OSM_NOMINATIM_BASE_URL

Nominatim API base URL. Override for a private or mirror instance.

Directory

Purpose

openstreetmap_lookup

Fetch address details for one or more known OSM objects by their IDs

OSM_USER_AGENT

User-Agent sent to Nominatim and Overpass. Required by usage policy.

OTEL_ENABLED

Enable OpenTelemetry

openstreetmap_reverse

Convert latitude/longitude coordinates to the nearest address or place name

openstreetmap_query_bbox

Find OSM features within a rectangular bounding box

STORAGE_PROVIDER_TYPE

Storage backend: `in-memory`, `filesystem`, `supabase`, `cloudflare-kv/r2/d1`

MCP_PUBLIC_URL

Public origin override for TLS-terminating reverse-proxy deployments

Variable

Description

OSM_OVERPASS_BASE_URL

Overpass API endpoint URL. Override for a mirror or private instance.

Tool

Description

openstreetmap_query_nearby

Find OSM features within a radius around a geographic point

MCP_HTTP_PORT

HTTP server port

MCP_HTTP_ENDPOINT_PATH

HTTP endpoint path where the MCP server is mounted

MCP_AUTH_MODE

Authentication: `none`, `jwt`, or `oauth`

MCP_GC_PRESSURE_INTERVAL_MS

Opt-in Bun-only forced-GC pressure loop (ms). Recommended starting point if heap growth is observed: `60000`.

openstreetmap_geocode

Convert a place name or address to geographic coordinates and structured place data

MCP_LOG_LEVEL

Log level (`debug`, `info`, `warning`, `error`, etc.)

openstreetmap_query_raw

Execute a raw Overpass QL query for advanced spatial operations

MCP_TRANSPORT_TYPE

Transport: `stdio` or `http`