Aidenyangx 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_search
   • クエリパラメータに基づいて地点情報を検索します。
   • 入力:
     • query（文字列）：検索キーワード
     • longitude（数値）：経度座標
     • latitude（数値）：緯度座標
   • 戻り値: 一致する地点のリスト

クラス図：

フローチャート：

🔧 エラー処理

すべてのツールは、包括的なエラー処理が実装されています。

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

📄 ライセンス

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