Mapbox MCP est le serveur officiel de Mapbox pour exposer ses API géospatiales au Model Context Protocol. Le dépôt mapbox/mcp-server décrit un serveur Node.js donnant accès au géocodage, à la recherche de lieux, aux itinéraires, aux matrices de temps de trajet, aux isochrones, au map matching, à l'optimisation de tournées, aux images statiques et à des calculs géospatiaux hors ligne. Lors de la vérification GitHub du 26 août 2026, le dépôt était sous licence MIT, comptait 352 étoiles et 41 forks, et le paquet npm @mapbox/mcp-server était en version 0.14.0.
Pour Educasium, Mapbox MCP a une place claire : c'est un connecteur d'intelligence géographique, utile quand un assistant doit raisonner sur un site, une adresse, un bassin d'accès ou une carte. Il ne remplace pas QGIS pour l'analyse SIG lourde, ni EnergyPlus pour la simulation énergétique. Il sert surtout à transformer une question spatiale en coordonnées, trajets, zones accessibles et supports visuels.
Sommaire
- Ce que fait Mapbox MCP
- Installation, endpoint hébergé et prérequis
- Outils de recherche, itinéraires et accessibilité
- Cartes interactives, images statiques et ressources
- Comparaison avec QGIS et EnergyPlus
- Sécurité, coûts et limites
- Position Educasium
Ce que fait Mapbox MCP
À retenir : Mapbox MCP donne à un client IA des outils pour comprendre où se trouvent les lieux, comment les relier et comment afficher le résultat sur une carte. Le serveur couvre à la fois des appels Mapbox payants ou soumis à quota et des calculs géospatiaux hors ligne basés sur Turf.js.
Familles de capacités
Le README vérifié présente Mapbox MCP comme une couche MCP au-dessus des API Mapbox. Les capacités principales sont le géocodage global, la recherche de points d'intérêt, les itinéraires voiture, marche et vélo avec trafic temps réel, les matrices de temps de trajet, l'optimisation de tournées, le map matching pour nettoyer des traces GPS, les isochrones et le rendu cartographique.
La partie intéressante pour une école, un cabinet ou une équipe immobilière est la combinaison de ces outils. Un assistant peut partir d'une adresse imprécise, demander une clarification au lecteur si plusieurs lieux correspondent, trouver des équipements proches, calculer une zone à 15 minutes de marche, puis rendre une carte. Cette chaîne serait pénible à faire à la main dans plusieurs interfaces séparées.
Ce qui reste hors périmètre
Mapbox MCP n'est pas un SIG complet. Il ne remplace pas la gestion de couches, la topologie avancée, les jointures attributaires, la mise en page cartographique professionnelle ou les traitements géographiques complexes de QGIS. Il ne remplace pas non plus une étude réglementaire, une étude de trafic ou une simulation thermique.
Il faut donc le présenter comme un connecteur d'accès et de visualisation. Pour des décisions d'urbanisme, d'implantation ou de logistique, il peut préparer les hypothèses et produire des cartes exploratoires, mais les conclusions doivent rester vérifiées par un professionnel et par les sources métiers.
Installation, endpoint hébergé et prérequis
À retenir : le dépôt propose un endpoint hébergé à https://mcp.mapbox.com/mcp et le paquet npm exige Node 22 ou plus. Dans tous les cas, un jeton d'accès Mapbox est requis pour utiliser les API Mapbox.
Deux modes d'usage
Le README propose d'abord un endpoint MCP hébergé. C'est le chemin le plus simple pour essayer le serveur, car le client MCP se connecte directement à l'URL Mapbox. Le lecteur doit néanmoins créer ou utiliser un jeton d'accès Mapbox depuis son compte. Cette exigence est importante : sans token, les outils qui appellent les API Mapbox ne peuvent pas fonctionner correctement.
Le dépôt propose aussi une exécution locale via le paquet @mapbox/mcp-server. Le package.json vérifié indique la version 0.14.0, une licence MIT, un binaire mcp-server et un moteur Node supérieur ou égal à 22. La dépendance @modelcontextprotocol/ext-apps explique la prise en charge des aperçus cartographiques riches dans certains clients MCP.
Clients et intégrations
Les guides du dépôt couvrent Claude Desktop, Goose, VS Code, Cursor et Smolagents. Le README mentionne aussi l'import direct des outils dans une application, ce qui est utile pour une équipe qui veut intégrer Mapbox MCP dans son propre agent plutôt que dans un client de bureau.
La présence de guides ne garantit pas une expérience identique partout. Les ressources MCP et les Apps MCP ne sont pas supportées de la même manière selon les clients. Le dépôt prévoit donc des outils de fallback pour les ressources quand un client ne sait pas lire nativement les ressources MCP.
Outils de recherche, itinéraires et accessibilité
À retenir : les outils Mapbox MCP sont particulièrement forts sur les questions d'accès, de proximité et de temps de trajet. Ce sont des questions fréquentes dans l'immobilier, l'architecture, l'enseignement, la mobilité et la logistique.
Recherche et géocodage
La recherche et le géocodage servent à convertir des textes en lieux exploitables. Le serveur regroupe recherche de lieux, géocodage, géocodage inverse, recherche par catégorie et détails de lieu. Dans un cas d'usage Educasium, un étudiant peut demander les équipements proches d'un campus, les services autour d'un terrain ou les commerces accessibles depuis une adresse.
Le README documente aussi ground_location_tool pour répondre à des questions centrées sur des coordonnées. Cet outil compose plusieurs stratégies selon la question : contexte de quartier, points d'intérêt proches, région accessible ou point routable le plus proche. Cette orchestration évite de chaîner manuellement plusieurs appels lorsque la demande est simplement : que trouve-t-on autour de ce point ?
Itinéraires, matrices et isochrones
Les directions couvrent plusieurs profils de déplacement, notamment voiture, voiture avec trafic, marche et vélo. Les matrices calculent des durées et distances entre plusieurs points, avec des cas un-vers-plusieurs, plusieurs-vers-un ou plusieurs-vers-plusieurs. Les isochrones affichent ce qui est atteignable depuis un point dans un temps ou une distance donnée.
Pour la décision spatiale, ces outils sont plus parlants qu'une distance à vol d'oiseau. Deux terrains à cinq kilomètres d'un centre peuvent avoir des accessibilités très différentes selon le réseau routier, les transports, les barrières urbaines et le profil de déplacement. Mapbox MCP permet à l'assistant de rendre ces différences visibles rapidement.
Cartes interactives, images statiques et ressources
À retenir : render_map_tool est la primitive visuelle centrale, mais static_map_image_tool reste le fallback fiable dans les clients sans rendu interactif. Le contenu doit expliquer cette différence, car elle change l'expérience utilisateur.
Rendu interactif
Le README vérifié explique que render_map_tool utilise le protocole MCP Apps pour afficher une carte Mapbox GL JS dans le client. Les clients cités comme compatibles incluent Claude Desktop, VS Code avec GitHub Copilot, Claude Code et Goose. Le même outil peut afficher des résultats produits par d'autres outils Mapbox ou du GeoJSON fourni directement.
Cette possibilité compte pour l'apprentissage. Une carte interactive permet de zoomer, inspecter, comparer et corriger. Dans un cours ou une démonstration, l'assistant peut générer une première carte, puis l'utilisateur peut demander une variante : autre profil de déplacement, rayon différent, fond satellite, markers supplémentaires ou polygone personnalisé.
Images et ressources
Le static_map_image_tool produit une image PNG ou JPEG encodée en base64. C'est moins souple qu'une carte interactive, mais beaucoup plus portable. Pour une page, un rapport ou un client MCP qui n'implémente pas MCP Apps, l'image statique reste le choix stable.
Le serveur expose aussi des ressources comme mapbox://categories et mapbox://categories/{language}. Ces ressources donnent les catégories utilisables pour la recherche de lieux. Pour les clients qui ne supportent pas les ressources MCP, le dépôt prévoit CLIENT_NEEDS_RESOURCE_FALLBACK=true afin d'exposer des outils de lecture équivalents.
Comparaison avec QGIS et EnergyPlus
À retenir : Mapbox MCP répond au où, QGIS MCP au travail SIG détaillé, EnergyPlus MCP à la performance énergétique simulée. Les trois connecteurs sont complémentaires plutôt que concurrents.
| Besoin | Mapbox MCP | QGIS MCP | EnergyPlus MCP |
|---|---|---|---|
| Trouver une adresse ou un POI | Très adapté | Possible via données importées | Hors périmètre |
| Calculer trajets et isochrones | Très adapté | Possible avec extensions/données | Hors périmètre |
| Manipuler couches SIG complexes | Limité | Très adapté | Hors périmètre |
| Produire une simulation bâtiment | Hors périmètre | Contexte spatial seulement | Très adapté |
| Générer une carte rapide dans le chat | Très adapté | Possible via rendu QGIS | Hors périmètre |
Choisir le bon outil
Pour une étude d'implantation rapide, Mapbox MCP est souvent le premier outil. Il répond vite aux questions de proximité, d'accessibilité et de visualisation. Si l'étude demande des couches cadastrales, des zonages, des traitements géographiques ou une mise en page cartographique contrôlée, QGIS MCP devient le bon choix.
Si la question porte sur l'énergie, le confort ou la performance du bâtiment, Mapbox ne suffit pas. Il peut aider à localiser le projet et à contextualiser le site, mais EnergyPlus MCP prend le relais pour charger un IDF, inspecter zones et matériaux, modifier des charges, lancer une simulation et analyser les résultats.
Sécurité, coûts et limites
À retenir : Mapbox MCP manipule des coordonnées, des adresses et un token API ; il faut donc cadrer confidentialité, quotas et contexte métier. Le serveur ne transforme pas une donnée sensible en donnée anodine.
Données envoyées
La section Data Usage & Privacy du README indique que les requêtes envoyées aux API Mapbox peuvent inclure adresses, textes de recherche, coordonnées, préférences de routage, waypoints, dimensions de véhicule, paramètres de carte et géométries. Pour l'exécution locale, le README indique que les appels partent directement de l'environnement utilisateur vers les API Mapbox et que le serveur local ne stocke pas les requêtes. L'endpoint hébergé https://mcp.mapbox.com/mcp ajoute un intermédiaire Mapbox et doit donc être évalué avec les conditions du service hébergé.
Cela ne supprime pas l'obligation de prudence. Une adresse de site confidentiel, un tracé logistique ou une zone d'intervention stratégique peut rester sensible. Dans un usage professionnel, il faut vérifier les conditions Mapbox, la politique de confidentialité applicable et les règles internes avant d'envoyer ces données.
Quotas et exactitude
Les outils en ligne dépendent des API Mapbox, des droits du token et des quotas du compte. Les calculs hors ligne, eux, ne consomment pas nécessairement d'appel API, mais ils restent dépendants de la qualité de la géométrie fournie. Une erreur de coordonnées ou de système de référence peut produire une carte convaincante mais fausse.
La bonne pratique Educasium est simple : toujours afficher les hypothèses. Adresse utilisée, coordonnées retenues, profil de déplacement, heure de départ, mode de transport, unité et source doivent être visibles dans le rendu ou dans la note d'accompagnement.
Position Educasium
À retenir : Educasium doit présenter Mapbox MCP comme un outil de raisonnement spatial assisté, pas comme une autorité finale. La valeur pédagogique est forte si les hypothèses et les limites sont explicites.
Ce qu'il faut enseigner
Un bon atelier Mapbox MCP commence par un cas concret : comparer deux sites pour un campus, vérifier l'accès à pied autour d'une adresse, produire une carte des services voisins ou visualiser une zone de 20 minutes en voiture. L'objectif n'est pas d'impressionner avec une carte, mais de montrer comment une IA transforme une demande vague en données spatiales vérifiables.
L'exercice doit inclure une étape de contrôle. L'étudiant vérifie le lieu choisi, compare le rendu avec une carte officielle ou un SIG, lit les hypothèses de routage et documente ce qui reste incertain. Cette discipline évite de confondre automatisation et validation.
Suite logique
Le positionnement reste sobre : Mapbox MCP est officiel, maintenu par Mapbox et riche fonctionnellement, mais il dépend d'APIs et de conditions externes. Les usages fiables, les prérequis techniques, le rôle du token et la complémentarité avec QGIS et EnergyPlus sont donc plus importants qu'une promesse de carte automatique.
La suite logique sur Educasium est un parcours en trois temps : Mapbox pour cadrer le site et l'accès, QGIS pour consolider l'analyse territoriale, EnergyPlus pour étudier la performance du bâtiment quand un modèle existe.