france-mcp

L'État français, branché sur l'IA.

19 outils · 12 sources officielles · zéro clé API · une ligne d'installation. + Légifrance en option avec une clé PISTE gratuite

Sirene, BOAMP, DVF, cadastre, Base Adresse Nationale, Géorisques, DPE, Caparéseau, data.gouv.fr, Service-Public.fr, Légifrance… Votre agent IA (Claude, Cursor, VS Code, n'importe quel client MCP) interroge directement les données publiques et cite ses sources.

Une question, l'État répond

« Je veux poser du solaire sur un hangar près de Rousset. Y a-t-il de la capacité réseau à côté ? » → adresse_geocoder → energie_postes_sources : poste de Rousset à 1,8 km du centre, 13,9 MW encore à affecter, quote-part 78,47 k€/MW.

« Ce fournisseur est-il solide ? » → entreprises_fiche : SIREN, dirigeants, chiffre d'affaires publié, labels RGE/Qualiopi, état administratif.

« Quels appels d'offres photovoltaïque sont encore ouverts dans les Bouches-du-Rhône ? » → marches_rechercher : avis du BOAMP, acheteur, date limite, lien direct.

« Prix au m² des appartements à Bordeaux depuis 2023 ? Risques à cette adresse ? Passoires thermiques dans la rue ? » → dvf_statistiques · risques_adresse · dpe_rechercher

Chaque réponse contient un champ source (nom officiel et URL). L'agent cite la source au lieu d'inventer.

Related MCP server: France Business Intelligence MCP

Installation

Rien à configurer, aucune clé à demander. Il faut juste Node.js 20 ou plus.

claude mcp add france -- npx -y github:tbsrgt/france-mcp

Dans claude_desktop_config.json (Réglages → Développeur → Modifier la configuration) :

{
  "mcpServers": {
    "france": {
      "command": "npx",
      "args": ["-y", "github:tbsrgt/france-mcp"]
    }
  }
}

Dans ~/.cursor/mcp.json :

{
  "mcpServers": {
    "france": { "command": "npx", "args": ["-y", "github:tbsrgt/france-mcp"] }
  }
}

code --add-mcp '{"name":"france","command":"npx","args":["-y","github:tbsrgt/france-mcp"]}'

git clone https://github.com/tbsrgt/france-mcp && cd france-mcp && npm install
node src/index.js --list     # liste les outils
npm run smoke                # appelle chaque outil sur les vraies API

Les 19 outils

Les outils se combinent. Par exemple, adresse_geocoder donne la latitude, la longitude et le code INSEE. On les passe ensuite au cadastre, à DVF, à Géorisques, aux DPE, à Caparéseau et à l'annuaire des services publics.

✅ Fidélité : 2 400 vérifications contre la source

Un connecteur qui déforme les données est pire que pas de connecteur. Pour le vérifier, npm run parity tire un échantillon déterministe (graine fixe) et compare chaque réponse champ par champ à un appel direct et indépendant de l'API officielle. L'outil est appelé à travers un vrai client MCP.

Résultat brut : test/parity-result.json. Relancez-le vous-même : npm run parity (environ 10 minutes). Pour un essai rapide : PARITY_N=50 npm run parity.

Choisir ses outils

Tout est actif par défaut. Pour alléger le contexte de l'agent, gardez seulement les groupes utiles :

npx -y github:tbsrgt/france-mcp --toolsets entreprises,marches
# ou : FRANCE_MCP_TOOLSETS=immobilier,batiment,territoires

Groupes disponibles : entreprises, territoires, immobilier, batiment, marches, datagouv, energie, services, legifrance.

Activer Légifrance

Légifrance passe par la plateforme PISTE de l'État. La clé est gratuite :

1. Créez un compte sur piste.gouv.fr, puis une application.

2. Abonnez l'application à l'API Légifrance et acceptez les CGU.

3. Passez les identifiants au serveur :

claude mcp add france -e PISTE_CLIENT_ID=xxx -e PISTE_CLIENT_SECRET=yyy -- npx -y github:tbsrgt/france-mcp

Le toolset Légifrance est en bêta. Contrairement aux autres sources, il ne fait pas partie des tests automatiques, faute de clé publique pour la CI.

Principes

• Lecture seule. Aucun outil n'écrit nulle part. Tous sont annotés readOnlyHint.

• Sources officielles uniquement, appelées en direct, sans base intermédiaire ni scraping de sites tiers. Exception documentée : Caparéseau ne publie pas d'API. On lit donc les fichiers JSON que son site met à disposition.

• Chaque réponse cite sa source. Le serveur demande à l'agent de la mentionner.

• Données personnelles minimisées. Les dirigeants sont publics (RNE), mais leur date de naissance n'est jamais renvoyée.

• Respect des API publiques : cache de 5 minutes, nouvelles tentatives espacées sur les erreurs 429 et 5xx, User-Agent identifiable.

• Zéro dépendance lourde : le SDK MCP officiel et zod, rien d'autre. Pas d'étape de compilation.

Feuille de route

Les contributions sont les bienvenues : chaque source tient dans un fichier de src/tools/.

• DECP : données essentielles de la commande publique (montants attribués)

• Comptes annuels déposés à l'INPI

• Hub'Eau : qualité de l'eau du robinet, nappes

• Bornes de recharge (IRVE) et prix des carburants en temps réel

• Météo-France et Vigilance

• PLU via le Géoportail de l'urbanisme

• Transport HTTP (Streamable HTTP) pour les clients distants

Contribuer

npm install
npm test          # tests hors ligne
npm run smoke     # chaque outil contre les vraies API (≈ 15 s)
npm run parity    # vérification de fidélité

Pour ajouter une source, créez src/tools/ma-source.js, qui exporte tools = [{ name, title, description, input, run }]. Déclarez-la ensuite dans src/registry.js et ajoutez un cas dans test/smoke.mjs.

france-mcp is an MCP server that gives any AI agent clean, read-only access to official French public data: company registry (Sirene/RNE), public procurement (BOAMP), real-estate transactions (DVF), land registry (cadastre), national address base, natural and industrial risks (Géorisques), energy performance certificates (ADEME), grid connection capacity for renewables (Caparéseau), data.gouv.fr, the public services directory, public holidays and, optionally, Légifrance (French law).

19 tools, no API key, one-line install: claude mcp add france -- npx -y github:tbsrgt/france-mcp. Every response carries its official source. Fidelity is checked by comparing tool outputs field by field against direct calls to the official APIs (npm run parity). Tool names and outputs are in French, like the data.

Licence

Code sous licence MIT. Les données restent celles de leurs producteurs : la plupart sont publiées sous Licence Ouverte Etalab 2.0. Citez la source indiquée dans chaque réponse.

Projet indépendant, sans lien avec l'administration française.