Mapbox MCP DevKit パターン

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

Mapbox MCP DevKit とは

Mapbox MCP DevKit Server は Model Context Protocol (MCP) サーバーで、AI アシスタントに Mapbox 開発者 API への直接アクセスを提供します:

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

主な利点: AI に開発者 API 操作を任せることで、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 を推奨
• 式の検証: paint/layout プロパティの確認には 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 を実行して paint/layout プロパティの全データ式を確認
3. check_color_contrast_tool を実行してテキストラベルが WCAG アクセシビリティ標準を満たしていることを確認
4. compare_styles_tool を実行して新しいスタイルを現在の本番スタイルと比較

トークン管理 — 以下の正確なステップを使用:

1. create_token_tool を実行して各環境 (開発/ステージング/本番) のスコープ付きトークンを作成
2. list_tokens_tool を実行して既存トークンとそのスコープを確認

リファレンスファイル

詳細なガイダンスが必要に応じてこれらのリファレンスをロード:

• references/setup.md - 前提条件、ホストおよび自己ホスト型インストール、エディタごとの設定、検証
• references/workflows.md - スタイル管理、トークン管理、データ検証、ドキュメンテーションアクセス、ベストプラクティス
• references/design-patterns.md - 反復的なスタイル開発、環境固有トークン、検証優先開発、ドキュメント駆動開発、ツール統合パターン
• references/troubleshooting.md - 一般的な問題と修正、エンドツーエンドワークフロー例 (レストランファインダー、マルチ環境、サードパーティデータ)

リソース

• Mapbox MCP DevKit Server
• Model Context Protocol
• Mapbox Style Specification
• Mapbox API Documentation
• Token Scopes Reference

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

以下の場合にこのスキルを呼び出します:

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