MCP Server

🚀 Mapbox MCP Server

Mapbox MCP Serverは、Mapbox APIに対応したModel Context Protocol (MCP)を実装したNode.jsサーバーです。このサーバーを使用することで、AIアプリケーションに地図情報や空間分析機能を組み込むことができます。

🚀 クイックスタート

前提条件

Mapbox MCP Serverを使用するには、Mapboxアクセストークンが必要です。以下の手順でトークンを取得してください。

1. mapbox.com/signup で無料のMapboxアカウントにサインアップします。
2. アカウントページ に移動します。
3. 新しいトークンを作成するか、デフォルトの公開トークンを使用します。

ホスト型MCPエンドポイントの使用

迅速にアクセスするには、ホスト型MCPエンドポイントを使用できます。

• エンドポイント: https://mcp.mapbox.com/mcp

各クライアントの詳細な設定手順とAPIの使用方法については、ホスト型MCPサーバーガイド を参照してください。

✨ 主な機能

地理空間情報の活用

Mapbox MCP Serverを使用すると、AIエージェントやアプリケーションを地理空間情報を理解できるシステムに変えることができます。以下のような機能を提供します。

• グローバルなジオコーディング: 住所や地名を座標に変換し、逆も可能です。
• 興味のある地点 (POI) 検索: 世界中の数百万の企業、ランドマーク、場所を検索できます。
• マルチモーダルルーティング: 自動車、徒歩、自転車でのルート検索が可能で、リアルタイムの交通情報も考慮されます。
• 旅行時間行列: アクセシビリティの分析や物流の最適化に役立ちます。
• 等時線生成: 特定の時間または距離制約内で到達可能なエリアを可視化します。
• 静的マップ画像: 場所、ルート、地理データの視覚的な表現を作成します。

MCPリソース

MCPサーバーは、静的な参照データをMCPリソースとして公開しています。リソースは、クライアントがツール呼び出しを行わずに直接参照できるデータへの読み取り専用アクセスを提供します。

• Mapboxカテゴリーリソース: mapbox://categories または mapbox://categories/{language} でアクセスできます。カテゴリーIDの完全なリストにアクセスし、検索結果をタイプでフィルタリングできます。

MCP-UIサポート

このMCPサーバーは、MCP-UIをサポートしています。MCP-UIは、互換性のあるクライアントが埋め込みiframeなどのインタラクティブなUI要素をレンダリングできるオープン仕様です。MCP-UIをサポートしていないクライアントとの完全な下位互換性も維持されます。

📦 インストール

Node.jsを使用する場合

# ビルド済みのイメージを実行
npm run inspect:build

Dockerを使用する場合

# Dockerイメージをビルド
docker build -t mapbox-mcp-server .

# サーバーを実行して検査
npx @modelcontextprotocol/inspector docker run -i --rm --env MAPBOX_ACCESS_TOKEN="YOUR_TOKEN" mapbox-mcp-server

💻 使用例

基本的な使用法

以下は、Claude Desktopや他のMCPクライアントで試せるプロンプトの例です。

場所の探索

• "エンパイアステートビルから徒歩圏内のコーヒーショップを探して"
• "ボストンからニューヨークまでのルート沿いのガソリンスタンドを表示して"
• "タイムズスクエアの近くにあるレストランはどれ？"

ナビゲーションと旅行

• "現在の交通状況を考慮して、LAXからハリウッドまでの運転ルートを取得して"
• "セントラルパークからタイムズスクエアまで徒歩でどれくらいかかりますか？"
• "ラッシュアワーにタクシーでホテル (フォーシーズンズ) からJFK空港までの旅行時間を計算して"

可視化とマップ

• "ゴールデンゲートブリッジからフィッシャーマンズワーフまでのルートを示すマップ画像を作成し、両地点にマーカーを付けて"
• "主要なランドマークをマークしたマンハッタンの衛星画像を表示して"
• "シアトルのダウンタウンから半径1マイル以内のすべてのスターバックスの場所を強調表示したマップを生成して"

分析と計画

• "ポートランドのダウンタウンから車で30分以内に到達できるエリアを表示して"
• "この3つのホテル (マリオット、シェラトン、ヒルトン) とデンバーの会議センターの間の旅行時間行列を計算して"
• "サンフランシスコのこの3つの観光名所 (ゴールデンゲート、ミュージカルステップ、フィッシャーマンズワーフ) を訪れる最適なルートを見つけて"

高度な使用法

# 新しいツールを作成
npx plop create-tool
# 接尾辞なしのツール名を指定 (例: Search)

📚 詳細ドキュメント

統合ガイド

• Claude Desktopのセットアップ
• Gooseのセットアップ
• VS Codeのセットアップ
• Cursor AI IDEのセットアップ
• Smolagentsの統合

ツールの説明

ユーティリティツール

• Resource Reader Tool: ネイティブのMCPリソースAPIをサポートしていないクライアントがMCPリソースにアクセスするためのツールです。

Mapbox APIツール

• Category List Tool (非推奨): 代わりに resource_reader_tool を使用してください。
• Matrix Tool: Mapbox Matrix API を使用して、複数の地点間の旅行時間と距離を計算します。
• Static image tool: Mapbox static image API を使用して、静的マップ画像を生成します。
• Category search tool: Mapbox Search Box category search API を使用して、カテゴリー検索を実行します。
• Reverse geocoding tool: Mapbox geocoding V6 API を使用して、逆ジオコーディングを実行します。
• Directions tool: Mapbox Directions API を使用して、ルート案内を取得します。
• Isochrone tool: Mapbox Isochrone API を使用して、等時線を計算します。
• Search and geocode tool: Mapbox Search Box Text Search API を使用して、POI、住所、場所の検索とジオコーディングを行います。

🔧 技術詳細

OpenTelemetryトレーシング

このMCPサーバーは、本番環境での観測性のためにOpenTelemetryトレーシングをサポートしています。

• クイックデモ: ローカル開発でのトレーシングの設定方法を示します。
• サポートされる観測プラットフォーム: AWS X-Ray、Azure Monitor、Google Cloud Traceなどのクラウドプロバイダーや、Datadog、New Relic、HoneycombなどのSaaSプラットフォームをサポートしています。
• 本番環境の設定: docs/tracing.md を参照してください。

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。

サポートと連絡先

MCPサーバーの問題

• メール: mcp-feedback@mapbox.com
• GitHubの問題: バグ報告と機能要求

Mapbox APIの質問

• Mapboxサポート: https://support.mapbox.com/
• ドキュメント: https://docs.mapbox.com/
• APIのステータス: https://status.mapbox.com/

メンテナンスのコミットメント

このMCPサーバーはMapbox, Inc.によって公式にメンテナンスされています。新しいMapbox API機能の定期的な更新、バグ修正、セキュリティ更新、最新のMCPプロトコルバージョンとの互換性、GitHubの問題を通じたコミュニティサポートを提供しています。