Bbox Mcp Server

🌍 bbox-mcp-server

どこでも、あらゆることを AI に尋ねて、地図で回答を確認できます。無料です

AI エージェントのための地理空間ツールキットです。ツールは 6 つ、設定は不要。オープンデータを使って、あらゆる LLM が空間データの検索、照会、変換、集計を行えるようにします。利用開始に API キーやサインアップは不要です。

すべての応答には、共有可能な検証リンク vibhorsingh.com/boundingbox が含まれます。クリックすると、インタラクティブマップで結果を視覚的に確認できます。この機能を備えた MCP サーバーはほかにありません。

これで何ができますか？

活用するのに GIS の専門家である必要はありません。 この MCP サーバーを使う AI エージェントなら、実際の OpenStreetMap データを使って空間に関する質問に回答でき、でたらめな幻覚を出力することもありません。

すべての回答にはリンクが付いています。クリックして AI の回答が正しいか確認でき、ほかの人と共有することもできます。

何が違うのか

多くの AI ツールは、信頼するしかないテキストを返します。このツールは、確認・検証できるインタラクティブマップを提供します！

• 検証可能 — すべての応答には、あなた（またはほかの人）が結果を視覚的に確認できる公開 URL が含まれます。あらゆる分野を見渡しても、この機能を備えた MCP サーバーはこれだけです。
• 決定論的 — クエリは実際の OpenStreetMap データに対して実行され、実際の座標を返します。AI が質問を解釈し、データは、素晴らしい OSM ボランティアの皆さんによるたゆまぬ努力の成果です。
• 無料 — 有料サービスはありません。Overpass API も OSM データも、このツールも無料です。Mapbox トークン（無料枠、支払い情報の登録不要）があれば自然言語による場所検索を利用できますが、必須ではありません。
• 設定不要 — npx -y bbox-mcp-server を実行すれば、すぐに使えます。

なぜ作られたのか

ツール一覧

すべてのツールは、location（自然言語。Mapbox トークンが必要）または bbox（座標、WKT、GeoJSON など）を受け付けます。

クイックスタート

MCP クライアントの設定に追加します。

{
  "mcpServers": {
    "bbox": {
      "command": "npx",
      "args": ["-y", "bbox-mcp-server"]
    }
  }
}

{
  "mcpServers": {
    "bbox": {
      "command": "npx",
      "args": ["-y", "bbox-mcp-server"]
    }
  }
}

{
  "mcpServers": {
    "bbox": {
      "command": "npx",
      "args": ["-y", "bbox-mcp-server"]
    }
  }
}

{
  "servers": {
    "bbox": {
      "command": "npx",
      "args": ["-y", "bbox-mcp-server"]
    }
  }
}

例：「Times Square から 500m 以内のコーヒーショップをすべて検索して」

オプションの設定

{
  "mcpServers": {
    "bbox": {
      "command": "npx",
      "args": ["-y", "bbox-mcp-server"],
      "env": {
        "MAPBOX_ACCESS_TOKEN": "pk.your-token-here",
        "OVERPASS_API_URL": "https://your.custom.overpass.instance/api/interpreter",
        "NOMINATIM_API_URL": "https://your.custom.nominatim.instance"
      }
    }
  }
}

またはグローバルにインストールします：npm install -g bbox-mcp-server

ツールリファレンス

get_bounds

6 種類の入力形式、9 種類の出力形式、3,900 以上の座標系に対応し、バウンディングボックスを変換・投影します。重心の中心点とタイル座標を返します。

💡 プロンプト： 「Central Park のバウンディングボックスを WKT 形式で取得し、EPSG:32618 に投影して」

get_h3_indices

バウンディングボックスをカバーする Uber H3 六角形セルのインデックスを生成します。

💡 プロンプト： 「シカゴ中心部の解像度 7 の H3 セルを、六角形ジオメトリを含めて取得して」

search_overpass

境界ボックスまたは半径内で Overpass クエリを実行します。名前、座標、タグを含む構造化された結果を返します。検証リンクでは、各結果が地図上にピンとして表示されます。

💡 プロンプト： 「JFK 空港から2km以内の駐車場をすべて探して」

💡 プロンプト： 「マンハッタンの病院を検索して。上限は50件」

list_osm_tags

Overpass クエリを作成する前に、カテゴリに対応する正しい OpenStreetMap タグを調べます。

💡 プロンプト： 「スーパーマーケットに対応する正しい OSM タグは何ですか？」

aggregate_overpass_h3

Overpass クエリを実行し、空間密度分析のために結果を H3 六角形に分類します。セルごとの件数と、六角形の境界を示す GeoJSON を返します。

💡 プロンプト： 「シアトルの病院をすべて、解像度7で H3 セルに集計して」

generate_share_url

vibhorsingh.com/boundingbox のインタラクティブマップ上で境界ボックスを表示する、共有可能なリンクを生成します。

💡 プロンプト： 「bbox 40.7128,-74.0060,40.7580,-73.9855 の共有リンクを生成して」

対応する入力形式

すべてのツールが入力形式を自動で判別します。使用する形式を指定する必要はありません。

🤖 AI エージェント開発者向け

レスポンス構造

各ツールは、次の2つのコンテンツブロックを返します。

1. 人が読めるテキスト — 地図の検証リンクを含む整形済みの出力
2. 構造化 JSON — 算出されたすべてのデータを含む、機械で解析可能なデータ

get_bounds の JSON レスポンスの例：

{
  "original_wgs84": { "lat1": 40.7128, "lng1": -74.006, "lat2": 40.758, "lng2": -73.9855 },
  "projected": { "xmin": -8238310.23, "ymin": 4970241.32, "xmax": -8235527.11, "ymax": 4976491.56 },
  "center": { "lat": 40.7354, "lng": -73.99575 },
  "tile_indices": { "z": 15, "x": 9660, "y": 12284 },
  "epsg": "3857",
  "coord_order": "lng,lat",
  "area_km2": 8.681,
  "dimensions": { "width_km": 1.714, "height_km": 5.066 },
  "share_url": "https://vibhorsingh.com/boundingbox/#40.712800,-74.006000,40.758000,-73.985500"
}

エラー処理

すべてのエラーは、説明メッセージとともにisError: trueを返します。無効な座標、未知の EPSG コード、過大な H3 リクエストはすべて適切にエラーとして返されます。サーバーは不正な入力によってクラッシュすることはありません。

ログ記録

構造化 JSON ログはstderrに出力されます（stdout は MCP プロトコル専用です）。各エントリーにはタイムスタンプ、レベル、コンテキストが含まれます。

謝辞と適正利用

OpenStreetMap

このツールはOpenStreetMapを基盤としています。OpenStreetMap は、何百万人ものボランティアが作成し、維持しているグローバルなデータセットです。実行するクエリによって返されるデータは、誰かが実際に歩いて調べ、地図に記録し、手作業で検証したものです。このツールが役立つと感じたら、OSM への貢献をご検討ください。

責任ある利用

公開されている Overpass API と Nominatim API のインスタンスは、容量に限りのある無料のコミュニティリソースです。短い間隔でのループや過剰なポーリング、大量のスクレイピングは避けてください。共有またはリモートの MCP サーバーとしてホストする場合は、NOMINATIM_API_URL と OVERPASS_API_URL をご自身のインスタンスまたは商用プロバイダーに向けてください（Overpass API のインストールおよび Nominatim のインストールを参照）。Overpass のデフォルトのサーバーローテーションは負荷の分散に役立ちますが、責任ある利用に代わるものではありません。

ライセンス

MIT