U.S. Census Bureau Data API MCP est le serveur MCP officiel du Census Bureau américain pour relier les assistants IA aux statistiques publiques du recensement. Le dépôt uscensusbureau/us-census-bureau-data-api-mcp indique qu'il connecte les assistants à la Census Data API et à d'autres sources officielles du Census Bureau, avec une base Postgres locale pour enrichir la recherche. Lors de la vérification GitHub du 26 août 2026, le dépôt était sous licence CC0-1.0, comptait 92 étoiles et 29 forks, et le package serveur mcp-server-census-api était en version 1.0.0.
Pour Educasium, Census MCP est une ressource de données, pas un outil créatif. Il sert à interroger des statistiques officielles par territoire américain, résoudre des géographies en codes FIPS, lister des jeux de données et récupérer des agrégats. Sa valeur pédagogique tient à la traçabilité : source publique, API documentée, variables, millésimes et niveaux géographiques.
Sommaire
- Ce que fait Census MCP
- Installation Docker, base locale et clé API
- Outils disponibles
- Géographies, FIPS, variables et millésimes
- Sécurité, limites et exactitude
- Comparaison avec Mapbox et QGIS
- Position Educasium
Ce que fait Census MCP
À retenir : Census MCP donne accès aux statistiques officielles du Census Bureau via une interface MCP, avec recherche enrichie par une base Postgres locale. Il est particulièrement utile pour les études de marché ou d'implantation aux États-Unis.
Source officielle
Le dépôt appartient à l'organisation GitHub uscensusbureau et le README parle de statistiques officielles du Census Bureau. Cette origine est importante : contrairement à beaucoup de connecteurs MCP communautaires, celui-ci vient de l'institution productrice des données.
Cela ne supprime pas le besoin de méthode. Une donnée officielle peut être mal sélectionnée, mal agrégée ou mal interprétée. Le bon dataset, la bonne année, la bonne variable et la bonne géographie restent essentiels.
Type de questions
Le serveur répond à des questions comme : quels datasets existent, quelles géographies sont disponibles pour un dataset, quel code FIPS correspond à un lieu, ou quelle valeur agrégée récupérer pour une zone. Il est donc adapté aux analyses démographiques, sociales, économiques et territoriales aux États-Unis.
Il n'est pas conçu pour la cartographie visuelle en direct ou les itinéraires. Pour cela, Mapbox MCP ou QGIS MCP sont plus adaptés. Census MCP apporte la donnée statistique qui peut ensuite nourrir une carte ou une analyse.
Installation Docker, base locale et clé API
À retenir : le README demande une clé API Census, Docker, Node 18+ et une initialisation de base au premier démarrage. Ce n'est pas un simple npx à lancer sans préparation.
Démarrage documenté
Le README indique qu'il faut cloner ou télécharger le projet, puis exécuter une commande docker compose avec le profil prod pour lancer migrations et seed. Cette étape tire des données depuis la Census Data API vers une base locale afin d'améliorer la recherche.
La configuration MCP exemple utilise un script bash scripts/mcp-connect.sh et une variable d'environnement CENSUS_API_KEY. Le README précise que CENSUS_API_KEY est requis et transmis au serveur via le script de connexion.
Package et architecture
Le package mcp-server-census-api utilise TypeScript, le SDK MCP, dotenv, node-fetch, pg et zod. Les scripts incluent build, lint, test, inspect et prepare. Le README décrit aussi une architecture avec mcp-server/src, server.ts, tools et schema.
Le serveur expose tools/list, tools/call, prompts/list et prompts/get. Cette séparation montre qu'il ne fournit pas seulement des appels de données ; il inclut aussi des prompts prédéfinis, comme un prompt de population qui résout d'abord la géographie avant de récupérer les données.
Outils disponibles
À retenir : le README documente quatre outils principaux, et la vérification du dossier source montre aussi search-data-tables en plus des fichiers de base. Les outils doivent être décrits à partir du README et du code source.
Outils documentés
list-datasets récupère un sous-ensemble de métadonnées pour les datasets disponibles dans l'API Census. fetch-dataset-geography récupère les niveaux géographiques disponibles pour un dataset donné, avec dataset requis et année optionnelle.
fetch-aggregate-data récupère des données agrégées depuis l'API Census. Il demande un dataset, une année, un objet get avec variables ou groupe, et des filtres géographiques comme for, in, UCGID ou predicates. resolve-geography-fips recherche des géographies et retourne des correspondances avec codes FIPS et paramètres de requête.
Outil repéré dans le code
La vérification du dossier mcp-server/src/tools a repéré base.tool.ts, fetch-aggregate-data.tool.ts, fetch-dataset-geography.tool.ts, list-datasets.tool.ts, resolve-geography-fips.tool.ts et search-data-tables.tool.ts. Le README consulté décrit les quatre premiers outils métier et le prompt population ; le fichier search-data-tables indique une surface source supplémentaire à vérifier lors d'une intégration réelle.
Cette distinction évite d'inventer une documentation détaillée que le README ne donne pas. On peut signaler l'existence du fichier source sans lui attribuer des paramètres non vérifiés.
Géographies, FIPS, variables et millésimes
À retenir : la qualité d'une réponse Census dépend du bon niveau géographique, du bon millésime et des bonnes variables. Ce n'est pas une recherche web libre.
Géographies
Le Census Bureau structure ses données par géographies : États, comtés, villes, tracts, zones et autres niveaux selon les datasets. resolve-geography-fips aide à trouver les codes nécessaires, mais il peut retourner plusieurs correspondances. L'utilisateur doit choisir la bonne zone.
fetch-dataset-geography sert à savoir quelles géographies sont valides pour un dataset. C'est indispensable : tous les datasets ne supportent pas tous les niveaux. Une requête invalide peut échouer ou pousser l'assistant à choisir une géographie plus large que prévu.
Variables et années
fetch-aggregate-data demande dataset et year. Les variables peuvent être nommées individuellement, comme NAME ou un code de variable, ou groupées via un groupe. Le paramètre descriptive peut ajouter des labels pour rendre la réponse plus lisible.
Une analyse sérieuse documente dataset, année, variables, géographie, filtres et date d'accès. Sans cela, une statistique devient difficile à vérifier ou à reproduire.
Sécurité, limites et exactitude
À retenir : Census MCP manipule des données publiques, mais il peut encore produire des conclusions fausses si la requête est mauvaise. Le risque principal est méthodologique.
Données publiques, conclusions sensibles
Les données Census sont publiques, mais les décisions qui en découlent peuvent être importantes : implantation, ciblage, politiques publiques, investissement, santé, éducation. Une erreur de variable ou de géographie peut modifier une recommandation.
La clé CENSUS_API_KEY doit rester hors dépôt. Le README demande de la fournir en variable d'environnement. Comme pour les autres connecteurs, les fichiers .env et scripts locaux doivent être contrôlés.
Base locale
Le projet utilise une base Postgres locale pour améliorer la recherche. Cela ajoute un cycle de vie : migrations, seed, reconstruction lors de mises à jour, et cohérence entre base locale et API. Le README indique qu'après une nouvelle version, il faut reconstruire l'environnement production.
Dans un atelier, il faut donc vérifier que la base a été initialisée et que la clé API fonctionne avant de faire des démonstrations.
Comparaison avec Mapbox et QGIS
À retenir : Census MCP fournit des statistiques officielles américaines ; Mapbox MCP calcule et affiche des lieux ; QGIS MCP manipule des couches SIG.
| Besoin | Census MCP | Mapbox MCP | QGIS MCP |
|---|---|---|---|
| Statistiques officielles USA | Très adapté | Hors périmètre | Données importées |
| Résoudre FIPS et géographies Census | Très adapté | Hors périmètre | Possible manuellement |
| Itinéraires et isochrones | Hors périmètre | Très adapté | Possible selon données |
| Traitements SIG et cartes complexes | Donnée source | Limité | Très adapté |
| Étude de marché USA | Très adapté | Contexte spatial | Cartographie et croisement |
Workflow combiné
Une étude d'implantation américaine peut commencer avec Census MCP pour récupérer population, ménages ou indicateurs économiques. Mapbox MCP peut ensuite évaluer accessibilité et proximité. QGIS MCP peut consolider les couches, croiser les zones et produire une carte finale.
Cette chaîne garde chaque outil dans son rôle : statistique officielle, intelligence de localisation, analyse SIG.
Position Educasium
À retenir : Educasium présente Census MCP comme un exemple de données officielles interrogeables par IA, avec obligation de citer dataset, variable, année et géographie.
Ce qu'il faut enseigner
Un bon exercice part d'une question simple : population d'une ville, comparaison de deux comtés, ou indicateur par État. L'assistant liste les datasets, vérifie les géographies, résout le FIPS, récupère les données et affiche les paramètres utilisés.
La compétence à apprendre n'est pas seulement obtenir un chiffre. Elle consiste à rendre ce chiffre vérifiable : source, année, variable, filtre géographique et limites d'interprétation.
Le contrôle final compare aussi le résultat avec la réponse brute ou la documentation Census quand l'indicateur devient stratégique. Cette dernière étape évite de transformer une donnée publique correcte en conclusion locale trop rapide.