mcp-service-public
Serveur MCP (Model Context Protocol) pour les donnees publiques francaises. Donne acces aux fiches pratiques service-public.fr, a la fiscalite locale, aux transactions immobilieres DVF, a la doctrine fiscale BOFiP, au zonage ABC, aux conventions collectives, a la recherche d'entreprises, a l'annuaire des etablissements scolaires, aux resultats des lycees (IVAL), aux evaluations nationales (6eme/CE2), aux formations Parcoursup, a l'acces aux soins (data.ameli.fr), a l'insertion professionnelle (InserJeunes), aux statistiques de securite/delinquance (SSMSI), aux risques naturels (Georisques), aux textes legaux Legifrance (lois, decrets, codes juridiques, jurisprudence), au Journal Officiel (JORF), aux statistiques d'aide sociale CAF (RSA/APL/AAH) et aux simulateurs (taxe fonciere, frais de notaire, impot sur le revenu).
Installation
Serveur heberge — aucune installation requise. Connectez l'URL suivante a votre client MCP :
https://mcp-service-public.nhaultcoeur.workers.dev/mcp
Claude.ai (web / mobile)
- Ouvrir Parametres (icone engrenage)
- Section Integrations > MCP
- Cliquer Ajouter une integration
- Coller l'URL ci-dessus
- Les 23 outils apparaissent automatiquement
Claude Desktop
Ajouter dans claude_desktop_config.json :
{
"mcpServers": {
"service-public": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp-service-public.nhaultcoeur.workers.dev/mcp"]
}
}
}
Emplacement du fichier :
- Windows :
%APPDATA%\Claude\claude_desktop_config.json - macOS :
~/Library/Application Support/Claude/claude_desktop_config.json
Redemarrer Claude Desktop apres modification.
VS Code / Cursor
Creer .vscode/mcp.json a la racine de votre projet :
{
"servers": {
"service-public": {
"type": "sse",
"url": "https://mcp-service-public.nhaultcoeur.workers.dev/mcp"
}
}
}
Autres clients MCP
Tout client compatible MCP Streamable HTTP peut se connecter avec l'URL ci-dessus. Consultez la documentation de votre client pour la configuration.
Verification
Apres connexion, testez avec une requete simple :
Recherche : renouveler passeport
Si les 38 outils sont charges, le serveur est pret.
Les 38 outils MCP (v1.14.8)
| # | Outil | Source | Description |
|---|---|---|---|
| 1 | rechercher | Dispatch unifie | Route automatiquement vers la bonne source selon la requete (32 categories) |
| 2 | rechercher_fiche | DILA / service-public.fr | Recherche plein texte dans ~5 500 fiches pratiques |
| 3 | lire_fiche | DILA / service-public.fr | Lecture complete d'une fiche par identifiant (F14929, N360...) |
| 4 | rechercher_service_local | API Annuaire | Services publics locaux (mairie, prefecture, CAF...) |
| 5 | naviguer_themes | DILA / service-public.fr | Navigation dans l'arborescence thematique |
| 6 | consulter_fiscalite_locale | DGFiP REI | Taux d'imposition locale par commune (TFB, TEOM, CFE...) |
| 7 | rechercher_doctrine_fiscale | BOFiP | 8 983 articles de doctrine fiscale en vigueur |
| 8 | consulter_transactions_immobilieres | DVF / data.gouv.fr | Prix medians, prix/m2, repartition par type de bien, evolution multi-annees |
| 9 | simuler_taxe_fonciere | REI + DVF | Estimation TF = VLC estimee x 50 % x taux REI reel |
| 10 | simuler_frais_notaire | Bareme reglemente | DMTO + emoluments degressifs + CSI + debours |
| 11 | consulter_zonage_immobilier | data.gouv.fr | Zone ABC (Pinel, PTZ, plafonds loyers/ressources) |
| 12 | comparer_communes | REI + DVF + zonage + Education + SSMSI + Georisques | Tableau croise de 2 a 5 communes (population, fiscalite, immobilier, education, sante, securite, risques naturels) |
| 13 | simuler_impot_revenu | Bareme IR 2025 | IR progressif, quotient familial, decote, CEHR, revenus fonciers/capitaux/BIC/BNC |
| 14 | rechercher_convention_collective | KALI / data.gouv.fr | Conventions collectives par IDCC ou mot-cle |
| 15 | rechercher_entreprise | DINUM + KALI | Fiche entreprise par SIRET/SIREN/nom + conventions applicables |
| 16 | rechercher_etablissement_scolaire | data.education.gouv.fr | Ecoles, colleges, lycees par commune (68 000+ etablissements) |
| 17 | consulter_resultats_lycee | DEPP / IVAL | Taux reussite bac, valeur ajoutee, acces 2nde-bac, mentions |
| 18 | consulter_evaluations_nationales | DEPP / data.education.gouv.fr | Scores 6eme + CE2 par departement, IPS, groupes de niveau, tendance |
| 19 | consulter_parcoursup | MESR / data.education.gouv.fr | Formations Parcoursup par mot-cle, ville, departement, filiere (14 000+ formations, selectivite, profil admis) |
| 20 | consulter_acces_soins | CNAM / data.ameli.fr | Acces aux soins par departement : effectifs/densite medecins, patientele MT, zones sous-dotees |
| 21 | consulter_insertion_professionnelle | DEPP-DARES / data.education.gouv.fr | Insertion pro InserJeunes : taux emploi 6/12/24 mois, poursuite etudes, VA par formation |
| 22 | consulter_securite | SSMSI / data.gouv.fr | Statistiques securite/delinquance departementales : cambriolages, vols, violences, taux/1000 hab. |
| 23 | consulter_risques_naturels | BRGM-MTE / georisques.gouv.fr | Risques naturels et technologiques par commune + arretes CatNat |
| 24 | rechercher_texte_legal | DILA / API PISTE Legifrance | Textes legislatifs et reglementaires (lois, decrets, arretes, ordonnances) |
| 25 | rechercher_code_juridique | DILA / API PISTE Legifrance | Articles dans les codes juridiques (Code civil, travail, penal, commerce...) |
| 26 | rechercher_jurisprudence | DILA / API PISTE Legifrance | Jurisprudence judiciaire (Cour de cassation, cours d'appel) |
| 27 | consulter_journal_officiel | DILA / API PISTE Legifrance | Recherche dans le Journal Officiel (JORF) : lois, decrets, arretes, ordonnances — filtre par type et plage de dates |
| 28 | consulter_aide_sociale | CNAF / data.caf.fr | Statistiques allocataires CAF par commune ou departement : RSA, APL/ALS/ALF, AAH, allocations familiales, prime d'activite... |
| 29 | rechercher_marche_public | DILA / boamp-datadila.opendatasoft.com | Avis marches publics BOAMP : appels d'offres, attributions, MAPA, DSP — filtre type/dept/acheteur/dates |
| 30 | rechercher_annonce_legale | DILA / bodacc-datadila.opendatasoft.com | Annonces legales BODACC : immatriculations, radiations, cessions, procedures collectives — filtre SIREN/nom/type/dept |
| 31 | consulter_budget_epci | OFGL / data.ofgl.fr | Budget des EPCI (metropoles, CA, CC, CU) : recettes/depenses, epargne, dette, euros/habitant — 2017-2024 |
| 32 | consulter_budget_commune | data.gouv.fr Tabular / OFGL | Budget primitif communes : recettes/depenses totales, epargne brute/nette, encours de dette, euros/habitant |
| 33 | rechercher_subvention | data.gouv.fr Tabular | Subventions collectivites >23 000 EUR — filtre beneficiaire/attribuant/objet/montant/annee |
| 34 | consulter_sirene_historique | API Recherche Entreprises DINUM | Entreprises SIRENE par NAF + zone — etat actif/cesse, dates creation et fermeture |
| 35 | rechercher_offre_emploi | France Travail OAuth2 | Offres d'emploi actives — filtre mots-cles, commune, departement, type contrat, qualification |
| 36 | consulter_prix_carburant | data.economie.gouv.fr | Prix carburants en temps reel par departement ou commune — stations triees par prix croissant, Gazole/SP95/SP98/E10/E85/GPLc, automate 24/24 (MAJ toutes les 10 min) |
| 37 | rechercher_formation | data.gouv.fr Tabular / Caisse des Depots | Formations CPF eligibles du catalogue MonCompteFormation — filtre mot-cle, departement, code ROME, niveau, a distance |
| 38 | consulter_parcoursup_stats | MESR / data.education.gouv.fr | Statistiques de selectivite Parcoursup par formation : taux d'acces, rang dernier appele, profil admis bac G/T/Pro, mentions, boursiers |
Exemples d'appels
Recherche unifiee (dispatch automatique)
{ "name": "rechercher", "arguments": { "query": "prix immobilier a Lyon" } }
{ "name": "rechercher", "arguments": { "query": "renouveler passeport" } }
{ "name": "rechercher", "arguments": { "query": "93140 taxe fonciere" } }
{ "name": "rechercher", "arguments": { "query": "SIRET 41816609600069" } }
Recherche d'entreprise
{ "name": "rechercher_entreprise", "arguments": { "siret": "41816609600069" } }
{ "name": "rechercher_entreprise", "arguments": { "nom": "OCTO Technology" } }
Simuler la taxe fonciere
{ "name": "simuler_taxe_fonciere", "arguments": { "commune": "Lyon", "surface": 75, "type_bien": "Appartement" } }
Simuler les frais de notaire
{ "name": "simuler_frais_notaire", "arguments": { "prix": 250000, "type": "ancien", "departement": "75" } }
Simuler l'impot sur le revenu
{ "name": "simuler_impot_revenu", "arguments": { "revenu_net_imposable": 42000 } }
{ "name": "simuler_impot_revenu", "arguments": { "revenu_net_imposable": 80000, "situation": "marie", "nb_enfants": 2 } }
{ "name": "simuler_impot_revenu", "arguments": { "revenu_net_imposable": 50000, "revenus_fonciers": 12000, "regime_foncier": "micro" } }
Conventions collectives
{ "name": "rechercher_convention_collective", "arguments": { "query": "boulangerie" } }
{ "name": "rechercher_convention_collective", "arguments": { "idcc": "3248" } }
Etablissements scolaires
{ "name": "rechercher_etablissement_scolaire", "arguments": { "commune": "Lyon", "type": "lycee" } }
{ "name": "rechercher_etablissement_scolaire", "arguments": { "code_postal": "93140", "statut": "public" } }
{ "name": "rechercher_etablissement_scolaire", "arguments": { "nom": "Lacassagne" } }
Resultats lycees (IVAL)
{ "name": "consulter_resultats_lycee", "arguments": { "commune": "Lyon" } }
{ "name": "consulter_resultats_lycee", "arguments": { "nom_lycee": "Lacassagne", "type": "gt" } }
Evaluations nationales (6eme / CE2)
{ "name": "consulter_evaluations_nationales", "arguments": { "code_departement": "93" } }
{ "name": "consulter_evaluations_nationales", "arguments": { "commune": "Lyon", "niveau": "6eme" } }
{ "name": "consulter_evaluations_nationales", "arguments": { "code_postal": "93140", "niveau": "CE2" } }
Formations Parcoursup
{ "name": "consulter_parcoursup", "arguments": { "recherche": "informatique", "ville": "Lyon" } }
{ "name": "consulter_parcoursup", "arguments": { "filiere": "BTS", "recherche": "comptabilite" } }
{ "name": "consulter_parcoursup", "arguments": { "departement": "93", "filiere": "Licence" } }
Statistiques selectivite Parcoursup
{ "name": "consulter_parcoursup_stats", "arguments": { "formation": "BTS comptabilite" } }
{ "name": "consulter_parcoursup_stats", "arguments": { "formation": "licence informatique", "ville": "Lyon" } }
{ "name": "consulter_parcoursup_stats", "arguments": { "formation": "CPGE scientifique", "filiere": "CPGE", "limit": 5 } }
Acces aux soins
{ "name": "consulter_acces_soins", "arguments": { "commune": "Bondy" } }
{ "name": "consulter_acces_soins", "arguments": { "code_departement": "93" } }
Insertion professionnelle (InserJeunes)
{ "name": "consulter_insertion_professionnelle", "arguments": { "ville": "Lyon", "limit": 5 } }
{ "name": "consulter_insertion_professionnelle", "arguments": { "uai": "0691723Y" } }
{ "name": "consulter_insertion_professionnelle", "arguments": { "recherche": "coiffure", "code_departement": "69" } }
Securite et delinquance
{ "name": "consulter_securite", "arguments": { "code_departement": "75" } }
{ "name": "consulter_securite", "arguments": { "commune": "Lyon" } }
Risques naturels
{ "name": "consulter_risques_naturels", "arguments": { "commune": "Nimes" } }
{ "name": "consulter_risques_naturels", "arguments": { "code_insee": "75056" } }
Textes legaux (Legifrance)
{ "name": "rechercher_texte_legal", "arguments": { "recherche": "protection donnees personnelles" } }
{ "name": "rechercher_texte_legal", "arguments": { "recherche": "teletravail", "champ": "TITLE" } }
Codes juridiques (Legifrance)
{ "name": "rechercher_code_juridique", "arguments": { "recherche": "contrat de travail", "code": "Code du travail" } }
{ "name": "rechercher_code_juridique", "arguments": { "recherche": "legitime defense", "code": "Code penal" } }
{ "name": "rechercher_code_juridique", "arguments": { "recherche": "1242", "code": "Code civil", "champ": "NUM_ARTICLE" } }
Jurisprudence (Legifrance)
{ "name": "rechercher_jurisprudence", "arguments": { "recherche": "licenciement abusif" } }
{ "name": "rechercher_jurisprudence", "arguments": { "recherche": "clause abusive", "juridiction": "Cour de cassation", "publie_bulletin": true } }
{ "name": "rechercher_jurisprudence", "arguments": { "recherche": "prejudice moral", "juridiction": "Cours d'appel" } }
Journal Officiel (JORF)
{ "name": "consulter_journal_officiel", "arguments": { "recherche": "teletravail" } }
{ "name": "consulter_journal_officiel", "arguments": { "recherche": "loi finances", "type_texte": "LOI", "date_debut": "2024-01-01", "date_fin": "2024-12-31" } }
{ "name": "consulter_journal_officiel", "arguments": { "recherche": "protection donnees", "type_texte": "DECRET", "limit": 10 } }
Aide sociale — statistiques CAF
{ "name": "consulter_aide_sociale", "arguments": { "commune": "Bondy" } }
{ "name": "consulter_aide_sociale", "arguments": { "code_departement": "93" } }
{ "name": "consulter_aide_sociale", "arguments": { "code_postal": "93140", "prestation": "RSA" } }
Marches publics (BOAMP)
{ "name": "rechercher_marche_public", "arguments": { "recherche": "travaux voirie", "departement": "35" } }
{ "name": "rechercher_marche_public", "arguments": { "type_avis": "AAC", "departement": "75" } }
{ "name": "rechercher_marche_public", "arguments": { "acheteur": "Departement du Rhone", "type_avis": "APC" } }
Annonces legales (BODACC)
{ "name": "rechercher_annonce_legale", "arguments": { "siren": "123456789" } }
{ "name": "rechercher_annonce_legale", "arguments": { "nom_entreprise": "SARL Martin" } }
{ "name": "rechercher_annonce_legale", "arguments": { "type_annonce": "procedure_collective", "departement": "69" } }
Consulter le zonage ABC
{ "name": "consulter_zonage_immobilier", "arguments": { "commune": "Bordeaux" } }
Comparer des communes
{ "name": "comparer_communes", "arguments": { "communes": ["Lyon", "Bordeaux", "Nantes"] } }
Fiscalite locale
{ "name": "consulter_fiscalite_locale", "arguments": { "code_postal": "93140" } }
{ "name": "consulter_fiscalite_locale", "arguments": { "communes": ["PARIS", "LYON", "MARSEILLE"] } }
Transactions immobilieres (DVF)
{ "name": "consulter_transactions_immobilieres", "arguments": { "commune": "Bondy", "type_local": "Appartement" } }
{ "name": "consulter_transactions_immobilieres", "arguments": { "commune": "Lyon", "evolution": true } }
Comment ca marche
Simulateur de taxe fonciere
VLC estimee = Surface ponderee x Tarif ajuste x Coef. entretien
Base imposable = VLC x 50 %
TF estimee = Base imposable x Taux global TFB (REI)
- Surface ponderee : surface habitable + equivalences confort
- Tarif ajuste : tarif VLC national x ratio prix local DVF / prix national
- Coef. entretien : selon l'anciennete du bien (0.90 a 1.15)
- Taux TFB : vrais taux votes par les collectivites (source REI DGFiP)
Simulateur de frais de notaire
Frais = DMTO + Emoluments TTC + CSI + Debours
- DMTO : 5,81 % (ancien, taux normal) ou 6,32 % (taux majore 2025) ; 0,71 % (neuf)
- Emoluments : bareme degressif reglemente (3,87 % -> 0,799 %) + TVA 20 %
- CSI : 0,10 % du prix (minimum 15 EUR)
- Debours : ~1 200 EUR (estimation)
Simulateur d'impot sur le revenu
Quotient familial = Revenu net imposable / Nombre de parts
IR brut = Bareme progressif applique au QF x Nombre de parts
IR net = IR brut - Decote (si applicable) + CEHR (si > 250k/500k)
Bareme 2025 (revenus 2024) : 0 % / 11 % / 30 % / 41 % / 45 %
Revenus complementaires supportes : fonciers (micro/reel), capitaux mobiliers (PFU/bareme), micro-BIC (50 %), micro-BNC (34 %).
Recherche d'entreprise
Recherche via l'API Recherche d'entreprises (DINUM) par SIRET, SIREN ou nom. Retourne forme juridique, NAF, effectif, dirigeants, adresse, et chaine vers KALI pour les conventions collectives applicables.
Etablissements scolaires
Proxy vers l'API Explore v2.1 de data.education.gouv.fr (Annuaire de l'education nationale, 68 000+ etablissements). Filtres : commune, code postal, type (ecole/college/lycee), statut (public/prive), nom. Retourne adresse, contact, voies d'enseignement, services (restauration, internat, ULIS, SEGPA), sections (europeenne, internationale, sport, arts).
Resultats lycees (IVAL)
Proxy vers les datasets IVAL GT et Pro de la DEPP (data.education.gouv.fr). Requetes paralleles GT + Pro, tri par valeur ajoutee decroissante. Indicateurs : taux de reussite au bac, valeur ajoutee, taux d'acces 2nde-bac, taux de mentions, effectifs par niveau. Sessions 2012-2024.
Architecture
Cloudflare Workers (plan payant)
+-- Transport : Streamable HTTP (POST /mcp)
+-- D1 SQLite (fiches DILA)
| +-- fiches (~5 500 fiches pratiques)
| +-- fiches_fts (index FTS5, tokenize unicode61)
| +-- themes (304 themes hierarchiques)
| +-- sync_log (historique des synchronisations)
| +-- tool_stats (statistiques d'usage)
+-- Proxy API (temps reel, cache + retry)
| +-- data.economie.gouv.fr -> REI fiscalite locale + BOFiP
| +-- data.gouv.fr -> DVF transactions + Zonage ABC + KALI conventions
| +-- data.education.gouv.fr -> Annuaire etablissements + IVAL lycees + Evaluations nationales + Parcoursup + InserJeunes
| +-- georisques.gouv.fr -> Risques naturels GASPAR + Arretes CatNat
| +-- data.ameli.fr -> Acces aux soins (effectifs, densite, patientele MT)
| +-- api.piste.gouv.fr -> Legifrance (textes legaux, codes juridiques, jurisprudence, JORF)
| +-- data.caf.fr -> Statistiques CAF allocataires (RSA, APL, AAH, AF, prime d'activite)
| +-- boamp-datadila.opendatasoft.com -> Marches publics BOAMP (appels d'offres, attributions, MAPA, DSP)
| +-- bodacc-datadila.opendatasoft.com -> Annonces legales BODACC (immatriculations, radiations, cessions, procedures collectives)
| +-- geo.api.gouv.fr -> Resolution communes
| +-- recherche-entreprises.api.gouv.fr -> Fiche entreprise
| +-- API Annuaire -> services publics locaux
+-- Cron (0 6 * * *) -> sync quotidienne DILA
Sources de donnees
| Source | Type | Donnees |
|---|---|---|
| DILA (lecomarquage) | ZIP quotidien -> D1 | Fiches pratiques, themes |
| API Annuaire | Proxy temps reel | Services publics locaux |
| data.economie.gouv.fr | Proxy temps reel | Fiscalite locale (REI), BOFiP doctrine |
| data.gouv.fr | Proxy temps reel | DVF transactions, Zonage ABC, KALI conventions collectives, SSMSI securite/delinquance |
| geo.api.gouv.fr | Proxy temps reel | Resolution communes (CP/INSEE/nom) |
| recherche-entreprises.api.gouv.fr | Proxy temps reel | Entreprises (SIRET/SIREN/nom, dirigeants, IDCC) |
| data.education.gouv.fr | Proxy temps reel | Annuaire etablissements scolaires, IVAL lycees, evaluations nationales 6eme/CE2, formations Parcoursup, insertion pro InserJeunes |
| georisques.gouv.fr | Proxy temps reel (API v1 GASPAR) | Risques naturels et technologiques par commune, arretes de catastrophe naturelle (CatNat) |
| data.ameli.fr | Proxy temps reel | Acces aux soins : effectifs/densite medecins, patientele MT, primo-installations, zones sous-dotees |
| api.piste.gouv.fr (DILA) | Proxy temps reel (OAuth2) | Legifrance : textes legaux (LODA), codes juridiques (CODE), jurisprudence (JURI/CAPP), Journal Officiel (JORF) |
| data.caf.fr (CNAF) | Proxy temps reel | Statistiques allocataires CAF par commune/departement : RSA, APL/ALS/ALF, AAH, AF, prime d'activite... |
| boamp-datadila.opendatasoft.com (DILA) | Proxy temps reel (Opendatasoft v2.1) | Marches publics BOAMP : appels d'offres, attributions, MAPA, DSP — mise a jour quotidienne |
| bodacc-datadila.opendatasoft.com (DILA) | Proxy temps reel (Opendatasoft v2.1) | Annonces legales BODACC : immatriculations, radiations, cessions, procedures collectives |
| data.economie.gouv.fr | Proxy temps reel (Opendatasoft v2.1) | Prix carburants flux instantane : stations-service, prix Gazole/SP95/SP98/E10/E85/GPLc, MAJ toutes les 10 min |
Endpoints
| Methode | Path | Description |
|---|---|---|
| POST | /mcp | Endpoint MCP (JSON-RPC) |
| GET | /health | Sante du service, version, outils, derniere erreur |
| GET | / | Description du service |
| GET | /openapi.json | Specification OpenAPI 3.1 (public, genere dynamiquement) |
| GET | /admin/dashboard | Dashboard HTML avec statistiques (auth requise) |
| GET | /admin/dashboard/api | API JSON du dashboard (auth requise) |
| POST | /admin/sync/full | Sync complete DILA (auth requise) |
| GET | /admin/sync | Statut des dernieres syncs (auth requise) |
Developpement
npm install
npm run dev # Serveur local
npx vitest run # Tests unitaires (~600 tests)
npm run typecheck # Verification TypeScript (0 erreurs)
npm run deploy # Deploiement Cloudflare
Stack technique
- TypeScript / Cloudflare Workers
- D1 SQLite + FTS5
- Vitest (tests unitaires)
- fflate (decompression ZIP)
- fast-xml-parser (parsing XML DILA)
- APIs : Annuaire, data.economie.gouv.fr, data.gouv.fr, geo.api.gouv.fr, recherche-entreprises.api.gouv.fr
Licence
MIT
Contribution
- Fork le repo
- Creer une branche (
git checkout -b feature/mon-outil) - Suivre le pattern : 1 fichier = 1 outil dans
src/tools/ - Ajouter l'import + definition + case dans
src/index.ts - Ecrire les tests dans
src/tools/__tests__/ - Push sur
main-> auto-deploy