Mapbox MCP Server

Mapbox MCP サーバー

Mapbox API 用の MCP サーバーです。

機能

ナビゲーションツール

1. mapbox_directions

   • 座標間の経路を取得します
   • 入力：
     • coordinates ({latitude: number, longitude: number}[])
     • profile（省略可能）："driving-traffic"、"driving"、"walking"、"cycling"
   • 戻り値：ステップ、距離、所要時間を含む経路の詳細

2. mapbox_directions_by_places

   • 場所の名前を使って、場所間の経路を取得します
   • 入力：
     • places (string[])：場所名の配列
     • profile（省略可能）："driving-traffic"、"driving"、"walking"、"cycling"
     • language（省略可能）：2 文字の言語コード（例："zh"、"en"）
   • 戻り値：
     • 各場所のジオコーディング結果
     • ステップ、距離、所要時間を含む経路の詳細
     • 処理中に発生したエラー

3. mapbox_matrix

   • 座標間の移動時間と距離の行列を計算します
   • 入力：
     • coordinates ({latitude: number, longitude: number}[])
     • profile（省略可能）："driving"、"walking"、"cycling"
     • annotations（省略可能）："duration"、"distance"、"duration,distance"
     • sources（省略可能）：始点座標のインデックス
     • destinations（省略可能）：目的地座標のインデックス
   • 戻り値：地点間の所要時間および／または距離の行列

4. mapbox_matrix_by_places

   • 場所の名前を使って、場所間の移動時間と距離の行列を計算します
   • 入力：
     • places (string[])：場所名の配列（2～25 件）
     • profile（省略可能）："driving"、"walking"、"cycling"
     • annotations（省略可能）："duration"、"distance"、"duration,distance"
     • language（省略可能）：2 文字の言語コード
     • sources（省略可能）：始点の場所のインデックス
     • destinations（省略可能）：目的地の場所のインデックス
   • 戻り値：
     • 各場所のジオコーディング結果
     • 所要時間および／または距離の行列
     • 処理中に発生したエラー

検索ツール

1. mapbox_geocoding
   • 場所を検索し、住所を座標に変換します
   • 入力：
     • searchText (string)：検索する場所または住所
     • limit（省略可能）：結果の最大数（1～10）
     • types（省略可能）：場所の種類で絞り込みます（country、region、place など）
     • language（省略可能）：2 文字の言語コード
     • fuzzyMatch（省略可能）：あいまい検索を有効または無効にします
   • 戻り値：座標やプロパティを含む詳細な位置情報

Claude Desktop との連携

この設定を 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 リクエスト
• Matrix API：
  • driving／walking／cycling の場合、1 分あたり 60 リクエスト
  • driving-traffic の場合、1 分あたり 30 リクエスト
• Geocoding 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 License の下でライセンスされています。MIT License の条項に従う限り、このソフトウェアを自由に使用、変更、配布できます。詳しくは、プロジェクトリポジトリの LICENSE ファイルをご覧ください。