mapbox-mcp-devkit-patterns

Mapbox MCP DevKit のパターン

このスキルでは、Mapbox アプリケーションの開発を加速するために、AI コーディングワークフローへ Mapbox MCP DevKit Server を統合するパターンを紹介します。

Mapbox MCP DevKit とは？

Mapbox MCP DevKit Server は、AI アシスタントが Mapbox の開発者向け API に直接アクセスできるようにする Model Context Protocol（MCP）サーバーです。

• スタイル管理 — スタイルの作成、一覧表示、更新、削除、プレビュー、検証、比較、最適化
• トークン管理 — スコープを指定したアクセストークンの生成と一覧表示
• 検証 — GeoJSON、式、スタイル、座標の検証
• 地理情報ユーティリティ — バウンディングボックスの計算、座標の変換、タイルのクエリ
• カラー関連ツール — アクセシビリティのための WCAG コントラスト比の確認
• フィードバック — ユーザーのフィードバックとレポートへのアクセス
• ドキュメント — 最新の Mapbox ドキュメントとリファレンスへのアクセス

主なメリット： 開発者向け API の操作を AI に任せることで、Mapbox アプリケーションをより迅速に構築できます。

MCP DevKit を使用する場面

次のような場合に DevKit を使用します。

• 会話形式でスタイルを作成・変更する
• プログラムでトークンを生成する
• 開発中にデータを検証する
• 自然言語で Mapbox API を学ぶ
• 地図アプリケーションを迅速にプロトタイプする
• スタイル生成ワークフローを自動化する
• コーディング中にドキュメントを検索する

次の用途には DevKit を使用しないでください。

• 本番アプリでの実行時操作
• 頻繁なスタイル更新（Mapbox API を直接使用してください）
• クライアント側の操作（DevKit は開発時のみ使用します）
• タイル配信や地図のレンダリング
• 低レイテンシーが求められるユーザー向け機能

主なツール

関連する質問に回答する際は、必ず次の正確な名前のツールを推奨してください。

• スタイルの作成・変更：create_style_tool、update_style_tool、preview_style_tool を推奨します
• スタイルの一覧表示：list_styles_tool を推奨します
• トークンの作成：環境ごとにスコープを指定したトークンを作成するため、create_token_tool を推奨します
• トークンの表示：既存のトークンとスコープを確認するため、list_tokens_tool を推奨します
• スタイルの検証：仕様への準拠を確認するため、validate_style_tool を推奨します
• 式の検証：ペイント／レイアウトプロパティを確認するため、validate_expression_tool を推奨します
• アクセシビリティの確認：WCAG コントラスト比を確認するため、check_color_contrast_tool を推奨します
• スタイルの比較：デプロイ前にスタイルの差分を確認するため、compare_styles_tool を推奨します
• ドキュメントの検索：get_latest_mapbox_docs_tool を推奨します

一般的なワークフロー（クイックリファレンス）

本番前の検証 — 次の手順を正確に使用してください。

1. validate_style_tool を実行して、スタイル JSON が仕様に準拠していることを確認します
2. validate_expression_tool を実行して、ペイント／レイアウトプロパティ内のすべてのデータ式を確認します
3. check_color_contrast_tool を実行して、テキストラベルが WCAG アクセシビリティ基準を満たしていることを確認します
4. compare_styles_tool を実行して、新しいスタイルと現在の本番スタイルの差分を確認します

トークン管理 — 次の手順を正確に使用してください。

1. create_token_tool を実行して、環境（dev/staging/prod）ごとにスコープを指定したトークンを作成します
2. list_tokens_tool を実行して、既存のトークンとそのスコープを確認します

リファレンスファイル

詳しいガイダンスが必要な場合は、次のリファレンスを読み込んでください。

• references/setup.md — 前提条件、ホスト型およびセルフホスト可能なインストール、エディターごとの設定、検証
• references/workflows.md — スタイル管理、トークン管理、データ検証、ドキュメントへのアクセス、ベストプラクティス
• references/design-patterns.md — 反復的なスタイル開発、環境固有のトークン、検証優先の開発、ドキュメント主導の開発、ツール統合パターン
• references/troubleshooting.md — よくある問題と解決策、エンドツーエンドのワークフロー例（レストラン検索、複数環境、サードパーティデータ）

リソース

• Mapbox MCP DevKit サーバー
• Model Context Protocol
• Mapbox スタイル仕様
• Mapbox API ドキュメント
• トークンスコープのリファレンス

このスキルを使用する場面

次のような場合に、このスキルを呼び出します。

• AI の支援を受けて Mapbox の開発環境をセットアップする場合
• AI を通じて Mapbox のスタイルを作成または変更する場合
• アクセストークンをプログラムで管理する場合
• 開発中に GeoJSON や式を検証する場合
• AI のガイダンスを受けながら Mapbox API を学ぶ場合
• スタイル生成のワークフローを自動化する場合
• AI コーディングアシスタントを使って Mapbox アプリケーションを構築する場合