streetmap-port

streetmap-port

OpenStreetMap の地理情報を CLI と stdio MCP サーバーの両方で提供する単一の バイナリです。地名を座標にジオコーディングし、座標から住所を逆ジオコーディングし、 場所を検索し、タイプと ID を指定して OSM オブジェクトを調べ、 地点の近くにあるカテゴリ別の場所を検索し、大円距離をローカルで計算できます。

ジオコーディング、逆ジオコーディング、検索には、利用ポリシーで求められる 説明的な User-Agent を指定して公開 Nominatim API を使用します。 近隣検索には公開 Overpass API を使用します。すべてのリクエストは 差し替え可能な fetch 関数を通じて送信され、リクエストの作成前に座標が検証されます。 API のエラーペイロードはエラーとして通知され、実在しない場所に置き換えられることは ありません。distance_between は純粋なローカルのハバースイン計算であり、 API 呼び出しは行いません。

インストール

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

終了コード：0 は成功、1 は API／検証エラー、2 は使用方法のエラーです。

MCP ツール

ツール	用途
geocode_address	OSM Nominatim API を介して、自由形式の住所や地名を座標にジオコーディングします
reverse_geocode	OSM Nominatim API を介して、座標を最寄りの住所に逆ジオコーディングします
search_places	OSM Nominatim API を介して、名前で場所を検索します
find_nearby	OSM Overpass API を介して、座標の近くにあるカテゴリ別の場所を検索します
get_place_details	Nominatim lookup API を介して、1 つの OSM オブジェクト（ノード、ウェイ、リレーション）の詳細を取得します
distance_between	2 組の座標間の大円距離をキロメートル単位で計算します（ローカル処理、API 呼び出しなし）

MCP クライアントの設定：

{
  "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

開発

npm install
npm run build
npm test

データ © OpenStreetMap の貢献者（ODbL）。コードは MIT ライセンスです。