Mapbox

@pipeworx/mapbox

Mapbox MCP — ジオコーディング、ルート検索、マトリックス、等時間圏、スタティックマップ URL、タイルクエリ。無料枠は月あたり約 50,000 リクエストです。

Pipeworx の一部です。AI エージェントを 1,882 以上のライブデータソースに接続する MCP ゲートウェイです。これは独立した非公式の連携であり、上流プロバイダーとの提携、承認、公開はありません。

認証

• プラットフォーム：PLATFORM_MAPBOX_KEY。BYO：?_apiKey=…（Mapbox アクセストークン）。

ツール

• geocode_forward(query, country?, types?, proximity?, bbox?, autocomplete?, limit?, language?, fuzzyMatch?) — 住所 → 座標
• geocode_reverse(lon, lat, country?, types?, language?, limit?) — 座標 → 住所
• directions(coordinates, profile?, alternatives?, geometries?, overview?, steps?, annotations?, voice_instructions?, banner_instructions?, language?) — ルート検索
• directions_matrix(coordinates, profile?, sources?, destinations?, annotations?) — 距離／所要時間マトリックス
• isochrone(profile, coordinates, contours_minutes?, contours_meters?, contours_colors?, polygons?, denoise?, generalize?) — 等時間圏
• map_matching(coordinates, profile?, geometries?, radiuses?, steps?, annotations?, overview?, timestamps?, tidy?) — GPS 軌跡を道路にスナップ
• tilequery(tileset_id, lon, lat, radius?, limit?, dedupe?, geometry?, layers?) — タイルのフィーチャーをクエリ
• static_image_url(style_id, lon, lat, zoom, width, height, bearing?, pitch?, retina?) — Static Image API の URL を返します（画像はサーバー側で取得されません）

profile：driving | walking | cycling | driving-traffic。coordinates：[[lon, lat], …]。

データソース

https://api.mapbox.com

クイックスタート

MCP クライアント（Claude Desktop、Cursor、Windsurf など）に追加します：

{
  "mcpServers": {
    "mapbox": {
      "url": "https://gateway.pipeworx.io/mapbox/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/mapbox/mcp の tools/list は、上の表にあるツールに加えて、Pipeworx の共通メタツール（ask_pipeworx、discover_tools、search_within、remember／recall など、ゲートウェイ全体で利用できるツール）も返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、パック独自のツールに加えて、共通ツールが約 30 個表示されます。接続の initialize 応答に正確な範囲が記載されており、その日付時点での確定情報となります。

これは意図的な設計であり、偶発的な多重化ではありません。メタツールを使うことで、このパックが対応していない質問にも、全カタログを横断してルーティングする ask_pipeworx を通じて回答できます。MCP サーバーを追加で 1 つ接続する必要はありません。現在、メタツールを含めずにパックのエンドポイントをマウントする方法はありません。追加のスキーマによるコンテキスト消費がルーティングの利点を上回る場合は、複数のパックエンドポイントではなく、フルゲートウェイに一度接続してください。

または、フル Pipeworx ゲートウェイに接続すると、このパックだけでなく、すべてのパックのツールが直接一覧表示されます：

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらの URL も、同じゲートウェイと 1,882 以上の同じデータソースに接続します。違いは、どのパックのツールが直接一覧表示されるかだけです。どちらを使っても、ask_pipeworx からすべてのツールにアクセスできます。

MCP クライアントがない場合：HTTP 経由で呼び出す

このパックでは独自の API キー（_apiKey）を使用します。こちらで API キーを用意していないため、キーなしで実行できる curl の例はありません。ツールの詳細を確認するには、GET https://gateway.pipeworx.io/v1/tools/geocode_forward を実行します。ツールを探すには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を実行します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージは、ローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントも、ゲートウェイへの往復も不要です：

{
  "mcpServers": {
    "mapbox": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-mapbox"]
    }
  }
}

または、直接実行して起動を確認します：

npx -y @pipeworx/mcp-mapbox

stdin/stdout 経由で MCP を使用し、initialize／tools/list／tools/call に対して、このパックのツールのみを返します。上記のゲートウェイ接続で追加される共通メタツールは含まれません。同じデータソース、同じツールで、ask_pipeworx によるルーティングはありません。

ask_pipeworx での使用

ツールを直接呼び出す代わりに、自然な英語で質問できます。 これは、上記のパックエンドポイントでも、フルゲートウェイでも機能します。

ask_pipeworx({ question: "your question about Mapbox data" })

ゲートウェイが適切なツールを選択し、引数を自動的に入力します。

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT