Mapbox MCP Server

🚀 Mapbox MCP サーバー

Mapbox API 用の MCP サーバーです。このサーバーは、Mapbox API を利用した様々な機能を提供し、ナビゲーションや入力検証、エラーハンドリングなどのタスクを効率的に行うことができます。

✨ 主な機能

ナビゲーションツール

1. mapbox_directions

   • 座標に基づいてナビゲーションルートを取得します。
   • 入力パラメータ:
     • coordinates ({latitude: number, longitude: number}[])
     • profile（オプション）："driving-traffic"、"driving"、"walking"、"cycling"
   • 返却結果: ステップ、距離、時間を含むルート情報

2. mapbox_directions_by_places

   • 地名に基づいてナビゲーションルートを取得します。
   • 入力パラメータ:
     • places（文字列配列）：地名の配列
     • 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（文字列配列）：地名の配列（2 - 25 個の地点）
     • profile（オプション）："driving"、"walking"、"cycling"
     • annotations（オプション）："duration"、"distance"、"duration,distance"
     • language（オプション）：2 文字の言語コード
     • sources（オプション）：出発地点のインデックス
     • destinations（オプション）：到着地点のインデックス
   • 返却結果:
     • 各地点の地理コード化結果
     • 距離行列データ
     • 処理中に発生したエラー情報

入力検証ツール

1. mapbox_input_validation
   • 入力パラメータの有効性を検証します。
   • サポートされる検証タイプ: required、string、integer、number、boolean、array、object
   • 返却結果:
     • 有効な入力データ
     • 検証失敗時の具体的なエラー情報

その他のツール

1. mapbox_error_handling
   • 様々な異常状況を処理します。
   • サポートされるエラータイプ: input_error、api_request_failure、rate_limit_exceeded、service_specific_error
   • 返却結果:
     • エラーコード
     • エラーメッセージ
     • 推奨される解決策

💻 使用例

Claude デスクトップ統合

{
  "name": "mapbox_mcp_server",
  "description": "Mapbox API の MCP サーバーツールセット",
  "version": "1.0.0",
  "parameters": {
    "api_key": {
      "type": "string",
      "required": true,
      "description": "Mapbox API のアクセスキー"
    },
    "tools": [
      "mapbox_directions",
      "mapbox_directions_by_places",
      "mapbox_matrix",
      "mapbox_matrix_by_places",
      "mapbox_input_validation",
      "mapbox_error_handling"
    ]
  }
}

📦 インストール

環境構成

1. 依存関係のインストール:

   npm install mapbox-mcp-server express validator
   

2. 環境変数の設定:

   process.env.NODE_ENV = 'production';
   process.env.MAPBOX_API_KEY = 'your_api_key_here';
   

📚 詳細ドキュメント

デプロイ構造

クラス図:

フローチャート:

エラーハンドリング

すべてのツールは、包括的なエラーハンドリングメカニズムを実装しています。

• 入力検証失敗
• API リクエスト失敗
• レート制限エラー
• サービス固有のエラー（例: 利用可能なルートがない、無効な座標）

📄 ライセンス

この MCP サーバーは MIT ライセンスの下で配布されています。これは、あなたが自由にソフトウェアを使用、修正、配布できることを意味しますが、MIT ライセンスの条項と条件に従う必要があります。詳細については、プロジェクトリポジトリ内の LICENSE ファイルを参照してください。