mapport

mapport

mapport は、場所に関する自然な質問を Google Maps Platform からの回答に変換します。住所から座標、座標から住所、テキストのクエリから場所の一覧を取得し、任意の 2 点間の距離、所要時間、またはステップごとのルートを返します。また、地点の海抜高度も報告します。1 つのバイナリで、スクリプト用のコマンドラインインターフェースとエージェント用の stdio MCP サーバーの両方を提供し、どちらも同じリクエスト処理を共有します。

Google Maps Platform の API キーが必要です。GOOGLE_MAPS_API_KEY 環境変数に設定してください。キーはすべてのリクエストで key クエリパラメーターとして Google に送信され、出力には表示されません。この環境変数が設定されていない場合は、リクエストを送信する前に、変数名を示すエラーですべての呼び出しが失敗します。

インストール

npx @reneturcios/mapport geocode "1600 Amphitheatre Parkway"

または、コンテナイメージを実行します。

docker run -i -e GOOGLE_MAPS_API_KEY ghcr.io/cloudcorprecords/mapport

コンテナはデフォルトで MCP サーバーを起動します（下記を参照）。CLI として使用するには、CLI 引数を渡してください。

CLI

export GOOGLE_MAPS_API_KEY="your API key"

mapport geocode "1600 Amphitheatre Parkway, Mountain View"
mapport reverse 37.422 -122.084
mapport search "coffee near the ferry building" --lat 37.7955 --lng -122.3937 --radius 1500
mapport details ChIJ2eUgeAK6j4ARbn5u_wAGqWA
mapport distance "San Francisco" "Oakland" --to "Berkeley" --mode driving
mapport elevation 37.422,-122.084 40.0,-70.0
mapport directions "San Francisco" "San Jose" --mode transit

mapport --version

各コマンドは、上流からの JSON ペイロードを出力します。終了コード：成功時は 0、呼び出し失敗時（GOOGLE_MAPS_API_KEY が設定されていない場合や API エラーを含む）は 1、使用方法のエラー時は 2 です。

MCP サーバー

1 つのバイナリで両方のインターフェースを提供します。mcp サブコマンドで stdio MCP サーバーを起動します。

npx -y @reneturcios/mapport mcp

MCP クライアントの設定：

{
  "mcpServers": {
    "mapport": {
      "command": "npx",
      "args": ["-y", "@reneturcios/mapport", "mcp"],
      "env": { "GOOGLE_MAPS_API_KEY": "your API key" }
    }
  }
}

ツール

ツール	入力	返される内容
maps_geocode	address（文字列、必須）	一致する場所の座標、整形済み住所、場所 ID。
maps_reverse_geocode	latitude（数値、必須）、longitude（数値、必須）	座標に最も近い住所とその構成要素。
maps_search_places	query（文字列、必須）、location（オブジェクト、任意）、radius（数値、任意）	クエリに一致する場所の名称、住所、位置。
maps_place_details	place_id（文字列、必須）	1 か所の詳細情報：連絡先情報、評価、レビュー、営業時間。
maps_distance_matrix	origins（文字列配列、必須）、destinations（文字列配列、必須）、mode（文字列、任意）	距離と移動時間のマトリックス。
maps_elevation	locations（{latitude, longitude} の配列、必須）	各地点の標高（メートル）。
maps_directions	origin（文字列、必須）、destination（文字列、必須）、mode（文字列、任意）	区間、手順、距離、所要時間を含むルート。

Google は多くの API エラーを、HTTP 200 のペイロード内のトップレベル status フィールドで報告します。mapport は、OK または ZERO_RESULTS 以外のステータスを、ステータスと Google 独自のメッセージを示すツールエラーとして返します。ZERO_RESULTS は、正直に空の回答として返します。

開発

npm install
npm run build   # tsc -> dist/
npm test        # node test runner over test/*.test.ts, no network (fake fetch fixtures)
npm run dev     # run the CLI from source via tsx

ライセンス

MIT — LICENSE を参照してください。