Streetmap Port

io.github.CloudCorpRecords由 GitHub 账号 CloudCorpRecords 发布v0.1.0更新于 Nov 7, 2026

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

发布方自己的服务:Port

概览

AI 生成的概览

本地 stdio MCP 服务器,为助手提供 OpenStreetMap 地理编码、地点搜索、周边查询和距离计算工具。

可以做什么
  • 把地址或地名转换为坐标,或把坐标反查为最近地址
  • 按名称搜索地点,并查询单个 OSM 节点、路径或关系的详情
  • 查找某坐标附近指定类别的地点
  • 在本地计算两组坐标之间的大圆距离,不发起任何 API 调用
适用场景
当助手需要把地址解析为坐标、查询 OpenStreetMap 地点、了解某位置周边有什么,或测量两点间距离,又不想自行搭建地理编码集成时适用。
运行要求
通过 npx(需 Node.js)或 Docker 作为本地进程运行。未声明需要账号、API 密钥或环境变量。除本地距离计算外,其余工具都需要访问公开的 Nominatim 和 Overpass API。
安装前请注意
查询会发送到公开的 OpenStreetMap Nominatim 和 Overpass 服务,搜索的地址和坐标会离开本机。这些公开 API 有使用政策和速率限制,高频或自动化使用可能被限流或封禁。结果依赖 OpenStreetMap 数据(ODbL),可能不完整或不准确。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Streetmap Port,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

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

bash
npx -y @reneturcios/streetmap-port mcp

CLI

bash
streetmap-port mcpstreetmap-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:

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

Docker

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

Development

bash
npm installnpm run buildnpm test

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

来源:README.md,提交 008e6f6

工具

6

geocode_address

Geocode a free-form address or place name to coordinates via the OSM Nominatim API

输入参数limitquery必填

reverse_geocode

Reverse geocode coordinates to the nearest address via the OSM Nominatim API

输入参数latitude必填longitude必填

search_places

Search for places by name via the OSM Nominatim API

输入参数limitquery必填

find_nearby

Find places of a category near coordinates via the OSM Overpass API

输入参数limitradiuscategorylatitude必填longitude必填

get_place_details

Get details of one OSM object (node, way or relation) via the Nominatim lookup API

输入参数osm_id必填osm_type必填

distance_between

Compute the great-circle distance in kilometres between two coordinate pairs (local, no API call)

输入参数to_latitude必填to_longitude必填from_latitude必填from_longitude必填

版本历史

1
  1. v0.1.0最新Oct 31, 2026

评分

已满足适用检查项的 90%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分
  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

其他 Port 集成