remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Provides navigation and geocoding capabilities through the Mapbox API, including routing between coordinates or place names, calculating travel time and distance matrices, and converting place names to coordinates.

Mapbox MCP サーバー

Mapbox API 用の MCP サーバー。

特徴

ナビゲーションツール

mapbox_directions
- 座標間の道順を取得する
- 入力:
  - coordinates ({緯度: 数値, 経度: 数値}[])
  - profile （オプション）: 「運転中の交通」、「運転」、「歩行」、「サイクリング」
- 返される値: 歩数、距離、所要時間を含むルートの詳細
mapbox_directions_by_places
- 場所の名前を使って場所間の道順を取得します
- 入力:
  - places (string[]): 地名の配列
  - profile （オプション）: 「運転中の交通」、「運転」、「歩行」、「サイクリング」
  - language （オプション）: 2文字の言語コード（例：「zh」、「en」）
- 戻り値:
  - 各場所のジオコーディング結果
  - 歩数、距離、所要時間を含むルートの詳細
  - 処理中に発生したエラー
mapbox_matrix
- 座標間の移動時間と距離行列を計算する
- 入力:
  - coordinates ({緯度: 数値, 経度: 数値}[])
  - profile （オプション）：「運転」、「徒歩」、「サイクリング」
  - annotations （オプション）: 「duration」、「distance」、「duration,distance」
  - sources （オプション）: ソース座標のインデックス
  - destinations （オプション）: 目的地の座標のインデックス
- 戻り値: 点間の期間および/または距離の行列
mapbox_matrix_by_places
- 場所の名前を使用して、場所間の移動時間と距離のマトリックスを計算します
- 入力:
  - places (string[]): 地名の配列（2～25か所）
  - profile （オプション）：「運転」、「徒歩」、「サイクリング」
  - annotations （オプション）: 「duration」、「distance」、「duration,distance」
  - language （オプション）: 2文字の言語コード
  - sources （オプション）: ソースの場所のインデックス
  - destinations （オプション）: 目的地のインデックス
- 戻り値:
  - 各場所のジオコーディング結果
  - 期間および/または距離のマトリックス
  - 処理中に発生したエラー

検索ツール

mapbox_geocoding
- 場所を検索し、住所を座標に変換する
- 入力:
  - searchText (文字列): 検索する場所または住所
  - limit (オプション): 結果の最大数 (1-10)
  - types （オプション）：場所の種類（国、地域、場所など）でフィルタリングします。
  - language （オプション）: 2文字の言語コード
  - fuzzyMatch (オプション): あいまい一致を有効/無効にする
- 戻り値: 座標やプロパティを含む詳細な位置情報

クロードデスクトップ統合

この構成を Claude Desktop 構成ファイル (通常は~/Library/Application Support/Claude/claude_desktop_config.jsonにあります) に追加します。

{
  "mcpServers": {
    "mapbox-mcp-server": {
      "command": "node",
      "args": ["/absolute/path/to/mapbox-mcp-server/build/index.js"],
      "env": {
        "MAPBOX_ACCESS_TOKEN": "your-api-key"
      }
    }
  }
}

設定

前提条件

Node.js 16以上
TypeScript 4.5以上
有効なMapbox APIキー

APIキー

ここの指示に従って Mapbox API キーを取得します。

API キーを環境変数として設定します。

export MAPBOX_ACCESS_TOKEN=your_api_key_here

レート制限

Directions API: 1 分あたり 300 リクエスト
マトリックスAPI:
- 運転/歩行/自転車で1分あたり60件のリクエスト
- 運転中の交通量に対する1分あたり30件のリクエスト
ジオコーディング API: 1 分あたり 600 リクエスト

展開

構造

mapbox-mcp-server では、次の構造を使用してサーバーのハンドラーを管理します。

src/server/handlers/base.ts : すべてのハンドラーの基本クラス
src/server/registry.ts : すべてのハンドラーのレジストリ
src/server/main.ts : サーバーのメインエントリポイント

各機能モジュールは次の構造に従います。

src/
├── types/          # Type definitions
├── schemas/        # Zod schemas for validation
├── tools/
│   ├── definitions/  # Tool definitions
│   └── handlers/     # Tool implementations
└── server/
    └── handlers/     # Handler classes

クラス図:

プロセス図：

エラー処理

すべてのツールは包括的なエラー処理を実装しています。

入力検証エラー
APIリクエストの失敗
レート制限エラー
サービス固有のエラー（例：ルートが見つからない、座標が無効）

ライセンス

このMCPサーバーはMITライセンスに基づいてライセンスされています。つまり、MITライセンスの条件に従って、ソフトウェアを自由に使用、改変、配布することができます。詳細については、プロジェクトリポジトリのLICENSEファイルをご覧ください。

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools