nutshell·mcp

Interrogez votre assistant IA sur n’importe quelle région européenne et obtenez des réponses sourcées.

nutshell-mcp est un serveur MCP qui réunit Eurostat, Copernicus et OpenStreetMap sur un grain unique — zone × indicateur × période. Votre assistant compare des régions, croise les sources et indique la fiabilité de chaque chiffre, sans jamais écrire de requête.

Serveur de démo Gratuit, sans clé, sans garantie. Pour un service opérationnel, faites tourner votre instance ou contactez-nous.

Carte des régions NUTS2 européennes ; les cinq régions de l’exemple sont mises en évidenceDE50DE60DE71DE72DE73DE80DE91BG41BG42CH01AT32AT33AT34BE23BE25BE32BE33BE34BE35BG31BG32BG33BG34DE92DE93DE94CZ07CZ08AL01AL02AL03AT11AT12AT13AT21AT22AT31DK05BE21BE22ES43ES51ES52ES53ES61ES62CH02CH03CH04CH05CH06CH07CY00CZ01CZ02CZ03CZ04CZ05CZ06DE40EL53EL54EL61EL62EL63ITC1ITC2DE11DE12DE13DE14DE21DE22DE23DE24DE25DE26DE27DE30EL42LV00ME00MK00NL11NL12EL64EL65ES11ES12ES13ES21ES22ES23ES24ES30IE05IE06ITC3FI19FI1BFI1CDEA1DEA2DEA3DEA4DEA5DEB1DEB2DEB3DEC0DED2DED4DED5DEE0DEF0DEG0DK01DK02DK03DK04ES41ES42HU23HU31HU32HU33IE04EE00EL30EL41EL43EL51EL52FI20FR10FRB0FRC1FRC2FRD2FRE1FRE2FRF1NL13NL21NL22NL23NL31NL32ITG2ITH1ITH2FRJ1FRJ2FRK1FRK2FRL0TR31TR32TR33HR03HR02HU11HU12HU21HU22PT16PT17FRF2FRF3FRG0FRH0FRI1FRI2ITC4ITF1ITF2ITF3ITF4ITF5ITF6ITG1LT01LT02LU00PL22PL41PL42PT18RO11RO12RO21RO22RO31RO32ITH3ITH4ITH5ITI1ITI2ITI3ITI4FI1DTR82PL43PL51PL52PL61PL62PL63PL71PL72PL81PL82PL84PL91PL92PT11PT15RS12RS21RS22SE11SE12NL33NL34NL41NL42PL21UKM6TR22UKC1UKC2UKD1UKD3UKD4UKD6UKD7UKE1UKE2UKE3RO41RO42RS11TR41TR42TR51TR52TR61TR62TR71TR81UKK1UKK2UKK3UKK4UKL1UKL2UKM5UKM7UKM8UKM9UKN0SE21SE22SE23SE31SE32SE33SI03SI04SK01SK02SK03SK04TR10TR21UKE4UKF1UKF2UKF3UKG1UKG2UKG3UKH1UKH2UKH3UKI5UKI6UKI7UKJ1UKJ2UKJ3UKJ4NO09NO0ANO0BHR05HR06NO02NO06NO07NO08BE24BE31FRD1FRI3FRM0
En bleu, les cinq régions NUTS2 retenues par l’assistant dans l’exemple ci-dessous.

Ce que votre assistant peut en faire

Trois familles de sources, un seul tableau. Chaque valeur porte son drapeau de qualité et sa provenance.

Eurostat
10 301 datasets

Statistiques officielles

PIB, chômage, population, structure par âge… du NUTS 0 au NUTS 2, plus le catalogue complet à son grain natif.

OpenStreetMap
38 pays

Ce qu'il y a sur le terrain

Hôpitaux, écoles, gares comptés par région et par ville.

Copernicus
2 300 régions et villes

Observation de la Terre

Rasters climatiques et d'occupation du sol convertis en statistiques régionales. Sur cette démo : température de surface estivale 2022–2024, Europe continentale (estimation échantillonnée).

Une question, plusieurs sources

Un vrai prompt, et un extrait de la réponse obtenue.

« Je dois choisir la région européenne où ouvrir une clinique gériatrique. Compare les régions NUTS2 de la France, de la Belgique et du Luxembourg : population la plus âgée, offre hospitalière la plus faible rapportée à la population, PIB par habitant correct. Donne-moi un top 5 justifié et précise la fiabilité de chaque source. »
search_indicators list_zones get_indicators search_datasets query_data
#Région (NUTS2)Dépendance 65+Lits / 100kPIB / hab.
1Brabant wallon (BE31)33,4 %225,3d69 500 €
2Poitou-Charentes (FRI3)47,3 %492,934 900 €
3Vlaams-Brabant (BE24)32,5 %377,4d57 100 €
4Basse-Normandie (FRD1)44,3 %557,234 600 €
5Corse (FRM0)43,2 %552,037 500 €

Le tableau est la partie facile. Comme chaque valeur porte son drapeau de qualité, l’assistant a aussi précisé :

  • Les nombres de lits belges sont marqués d (définition différente) : la comparaison France/Belgique est indicative, et les rangs 1 et 3 sont belges.
  • OpenStreetMap ne recense aucun hôpital dans les départements d’outre-mer : un défaut de complétude, ils ont donc été exclus plutôt que classés.
  • Le Luxembourg n’a pas de données sur les lits : « un trou dans les données, pas une mauvaise note ».
  • Les valeurs 2025 marquées [p] sont provisoires.

Plus d’exemples de prompts et des enchaînements de tools qu’ils déclenchent →

Croiser les trois sources

Certaines questions exigent trois regards à la fois sur un territoire : qui y vit (Eurostat), quel est le milieu (Copernicus) et de quoi dispose-t-on (OpenStreetMap). Trois vrais runs avec Qwen3.8-27B, chiffres vérifiés contre les données du serveur.

Canicules et personnes âgées

Copernicus × Eurostat × OSM · NUTS3
« Parmi les provinces d'Espagne et d'Italie, lesquelles cumulent les étés les plus chauds, la population la plus âgée et le moins d'hôpitaux pour 100 000 habitants ? »
#Province65+ / 15–64HôpitauxPour 100k
1Asti (ITC17)45,2 %20,97
2Lecce (ITF45)42,6 %182,35
3Terni (ITI22)48,0 %41,86

L'assistant a jugé les comptages d'hôpitaux OSM « le maillon faible » et présenté son top 10 comme « une liste indicative, pas un ordre précis ».

Déménager avec de jeunes enfants

Copernicus × Eurostat × OSM · NUTS2
« Allemagne ou Autriche : étés doux, faible chômage, le plus d'écoles et de gares possible rapporté à la population. »
#RégionÉtéChômageÉcoles / 1 000
1Oberösterreich19,7 °C3,8 %0,64
2Steiermark18,4 °C4,4 %0,61
3Lüneburg18,7 °C2,7 %0,49

Un seul appel, 5 indicateurs issus de 3 sources sur 45 régions. L'assistant a aussi listé ce que les données ne disent pas : places en crèche, coût du logement, fréquence des trains.

Tourisme d'été, chaleur et train

Eurostat × Copernicus × OSM · NUTS2
« Parmi les régions d'Espagne, d'Italie, de Grèce et de Croatie, lesquelles accueillent le plus de nuitées, ont les étés les plus chauds, et sont-elles bien desservies par le train ? »
#RégionNuitées étéÉtéGares / 100 000
1Jadranska Hrvatska63,0 M23,6 °C3,8
2Cataluña40,3 M23,9 °C5,3
3Illes Balears37,7 M26,9 °C2,9

Nuitées de juin à août, tirées de la série mensuelle Eurostat. Les régions les plus chaudes ne sont pas les plus visitées, et les destinations les plus fréquentées sont parmi les moins desservies par le train.

Prompts, réponses et transcripts complets →

Essayer dans le navigateur

Apportez votre modèle : choisissez un fournisseur, collez sa clé d'API et posez votre question. La page appelle votre fournisseur et le serveur de démo directement depuis cet onglet.

Obtenir une clé

Avancé

Votre clé reste dans cet onglet (session storage) et n'est envoyée qu'au fournisseur choisi, jamais à nutshell. OpenRouter permet aussi d'essayer un modèle ouvert de 27B.

Les appels de tools comptent dans le quota de démo (100 par jour et par IP) ; les tokens sont facturés par votre fournisseur.

Connectez votre assistant

Tout client qui parle MCP en HTTP : Claude Desktop, Claude Code, Cursor, pi, et d’autres.

7 tools

Pensé pour les petits modèles. Schémas étroits, sorties bornées, erreurs qui suggèrent la correction : fonctionne avec un modèle local de 27B, pas seulement avec les modèles de pointe.

Ajouter le serveur

Plugin Claude Code : deux commandes, rien d’autre à installer.

/plugin marketplace add scampion/nutshell-mcp
/plugin install nutshell@nutshell

Tout autre client MCP : endpoint https://nutshell.arcamens.ai/mcp (HTTP streamable, sans clé).

{
  "mcpServers": {
    "nutshell": {
      "type": "http",
      "url": "https://nutshell.arcamens.ai/mcp"
    }
  }
}

Claude Code sans le plugin : claude mcp add --transport http nutshell https://nutshell.arcamens.ai/mcp

Posez une question sur des territoires

« Compare le chômage et l’âge médian en Île-de-France, Oberbayern et Lombardia. » L’assistant trouve les indicateurs et les codes de zone, puis renvoie un seul tableau.

Demandez les sources

Ajoutez « précise la fiabilité de chaque source » : c’est ce qui pousse l’assistant à raisonner sur les valeurs provisoires, les changements de définition et les lacunes de couverture.

Faire tourner votre propre instance

Recommandé pour tout usage réel. Le serveur est sans état et sert tout depuis le disque local : une fois synchronisé, il fonctionne entièrement hors ligne, et vous choisissez les indicateurs, les pays et la cadence de rafraîchissement.

git clone https://github.com/scampion/nutshell-mcp.git
cd nutshell-mcp
uv venv --python 3.12 .venv
uv pip install --python .venv/bin/python -e .

.venv/bin/python -m nutshell_mcp.sync --source geo        # géométries NUTS & villes
.venv/bin/python -m nutshell_mcp.sync --source eurostat   # indicateurs du registre
.venv/bin/python -m nutshell_mcp.server                   # serveur MCP stdio

Ajouter un indicateur = un fichier YAML, sans code. Les pipelines OSM et Copernicus, le déploiement HTTP et la configuration sont décrits dans le README (English version).

Au-delà de la démo

Le code est open source. Si le serveur de démonstration ne suffit plus, nous pouvons vous accompagner.

Instance hébergée

Un serveur opérationnel avec engagement de disponibilité, authentification et les indicateurs dont vous avez besoin.

Support entreprise

Déploiement sur votre infrastructure, intégration à vos assistants et modèles, formation.

Données sur mesure

Nouveaux indicateurs, sources internes jointes aux NUTS, géographies ou cadences de rafraîchissement spécifiques.