Back to Browse

Streetmap Port MCP Server

Developer ToolsModerate6.2MCP RegistryLocal
Free

Server data from the Official MCP Registry

Geocode, reverse geocode and find nearby places with the public OpenStreetMap APIs.

About

Geocode, reverse geocode and find nearby places with the public OpenStreetMap APIs.

Security Report

6.2
Moderate6.2Moderate Risk

streetmap-port is a clean, well-structured OpenStreetMap CLI and MCP server that calls only the public Nominatim and Overpass APIs, validates coordinates and Overpass category input before building requests, and surfaces API errors rather than inventing results. No authentication is required, which is appropriate since the public OSM APIs need no credentials, and the only permissions requested (outbound HTTP to two OSM endpoints) match its stated purpose. Minor observations are limited to informational notes about the unauthenticated public API usage and the lack of an explicit response size limit. Supply chain analysis found 4 known vulnerabilities in dependencies (0 critical, 2 high severity). Package verification found 1 issue.

8 files analyzed · 8 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-cloudcorprecords-streetmap-port": {
      "args": [
        "-y",
        "@reneturcios/streetmap-port"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

streetmap-port

OpenStreetMap geography as a CLI and a stdio MCP server in one bin: geocode a name to coordinates, reverse geocode coordinates to an address, search places, look up an OSM object by type and id, find places of a category near a point, and compute great-circle distances locally.

Geocoding, reverse geocoding and lookup use the public Nominatim API (with the descriptive User-Agent its usage policy requires); nearby search uses the public Overpass API. All requests go through an injectable fetch function, coordinates are validated before any request is built, and API error payloads are surfaced as errors — never replaced with invented places. distance_between is a pure local haversine computation and makes no API call.

Install

npx -y @reneturcios/streetmap-port mcp

CLI

streetmap-port mcp
streetmap-port geocode <query...>
streetmap-port reverse <lat> <lon>
streetmap-port search <query...>
streetmap-port nearby <lat> <lon> [category] [radius-m]
streetmap-port distance <lat1> <lon1> <lat2> <lon2>
streetmap-port --version

Exit codes: 0 success, 1 API/validation error, 2 usage error.

MCP tools

ToolPurpose
geocode_addressGeocode a free-form address or place name to coordinates via the OSM Nominatim API
reverse_geocodeReverse geocode coordinates to the nearest address via the OSM Nominatim API
search_placesSearch for places by name via the OSM Nominatim API
find_nearbyFind places of a category near coordinates via the OSM Overpass API
get_place_detailsGet details of one OSM object (node, way or relation) via the Nominatim lookup API
distance_betweenCompute the great-circle distance in kilometres between two coordinate pairs (local, no API call)

MCP client config:

{
  "mcpServers": {
    "streetmap-port": {
      "command": "npx",
      "args": ["-y", "@reneturcios/streetmap-port", "mcp"]
    }
  }
}

Docker

docker run -i ghcr.io/cloudcorprecords/streetmap-port          # MCP server
docker run --rm ghcr.io/cloudcorprecords/streetmap-port --version

Development

npm install
npm run build
npm test

Data © OpenStreetMap contributors (ODbL). MIT license for the code.

Reviews

No reviews yet

Be the first to review this server!