io.github.cyanheads/openstreetmap-mcp-server MCP Server

io.github.cyanheads/openstreetmap-mcp-server

Repository Registry

What is the io.github.cyanheads/openstreetmap-mcp-server MCP server?

Geocode, reverse geocode, and run Overpass spatial queries on OpenStreetMap data.

How to install io.github.cyanheads/openstreetmap-mcp-server

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

OSM_NOMINATIM_BASE_URL
Nominatim API base URL. Override to use a private or mirror instance.
OSM_USER_AGENT
User-Agent sent to Nominatim and Overpass. Required by usage policy.
OSM_OVERPASS_BASE_URL
Overpass API endpoint URL. When set, pins every query to this one endpoint and disables mirror failover. Leave unset to use OSM_OVERPASS_ENDPOINTS.
OSM_OVERPASS_ENDPOINTS
Comma-separated ordered list of Overpass endpoints. A transient failure advances to the next entry within the same tool call; a single entry means no failover. Verify a mirror's usage policy, data coverage, and freshness before adding it. Ignored when OSM_OVERPASS_BASE_URL is set.
OSM_OVERPASS_MAX_CONCURRENCY
Maximum Overpass queries submitted at once. Match the slot budget the endpoint advertises at /api/status.
MCP_LOG_LEVEL
Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').
MCP_HTTP_HOST
The hostname for the HTTP server.
MCP_HTTP_PORT
The port to run the HTTP server on.
MCP_HTTP_ENDPOINT_PATH
The endpoint path for the MCP server.
MCP_PUBLIC_URL
Public origin override for deployments behind a TLS-terminating reverse proxy (e.g. https://mcp.example.com).
MCP_AUTH_MODE
Authentication mode to use: 'none', 'jwt', or 'oauth'.

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "openstreetmap-mcp-server": {
      "command": "bun",
      "args": [
        "-y",
        "@cyanheads/openstreetmap-mcp-server",
        "run",
        "start:stdio"
      ],
      "env": {
        "OSM_NOMINATIM_BASE_URL": "<YOUR_OSM_NOMINATIM_BASE_URL>",
        "OSM_USER_AGENT": "<YOUR_OSM_USER_AGENT>",
        "OSM_OVERPASS_BASE_URL": "<YOUR_OSM_OVERPASS_BASE_URL>",
        "OSM_OVERPASS_ENDPOINTS": "<YOUR_OSM_OVERPASS_ENDPOINTS>",
        "OSM_OVERPASS_MAX_CONCURRENCY": "<YOUR_OSM_OVERPASS_MAX_CONCURRENCY>",
        "MCP_LOG_LEVEL": "<YOUR_MCP_LOG_LEVEL>",
        "MCP_HTTP_HOST": "<YOUR_MCP_HTTP_HOST>",
        "MCP_HTTP_PORT": "<YOUR_MCP_HTTP_PORT>",
        "MCP_HTTP_ENDPOINT_PATH": "<YOUR_MCP_HTTP_ENDPOINT_PATH>",
        "MCP_PUBLIC_URL": "<YOUR_MCP_PUBLIC_URL>",
        "MCP_AUTH_MODE": "<YOUR_MCP_AUTH_MODE>"
      }
    }
  }
}

Related MCP servers

io.github.cyanheads/orcid-mcp-server

Active

Researcher profiles, works, affiliations, funding, and peer reviews from the ORCID registry.

TypeScript

View repository →

io.github.cyanheads/osv-advisory-mcp-server

Active

Query OSV.dev for package vulnerabilities and batch-audit dependency lists via MCP.

TypeScript

Apache-2.0

View repository →

io.github.cyanheads/ourairports-mcp-server

Active

Offline global aviation reference — airports, runways, navaids, frequencies from OurAirports.

TypeScript

Apache-2.0

View repository →

io.github.cyanheads/paleobiology-mcp-server

Active

Search fossil occurrences, taxon ranges, diversity through deep time, and the geologic time scale.

TypeScript

Apache-2.0

View repository →

io.github.cyanheads/pentest-mcp-server

Active

Offline methodology engine for authorized penetration testing, CTF, and security research.

TypeScript

Apache-2.0

View repository →

io.github.cyanheads/pixoo-mcp-server

Active

Render and push styled pixel art, text, dashboards, and animations to Divoom Pixoo LED displays.

TypeScript

Apache-2.0

View repository →