Données ISTAT pour votre agent

Présentation

Ce serveur MCP (Model Context Protocol) donne à un client compatible un accès aux données statistiques de l’ISTAT, l’institut national italien de la statistique, par l’API REST SDMX. Il expose huit outils : découverte des jeux de données, structure, contraintes, descriptions des listes de codes, concepts, données au format TSV, diagnostic du cache et codes territoriaux.

Le serveur conserve un cache en mémoire et sur disque, limite les appels à quatre par minute avec une file d’attente, et relance les requêtes après une erreur transitoire. Le dépôt contient aussi un skill qui guide le modèle étape par étape, ainsi qu’un mode HTTP avec Dockerfile et chart Helm.

Points forts

• Huit outils MCP : découverte des jeux de données, structure, contraintes, descriptions de listes de codes, concepts, données, diagnostic du cache et codes territoriaux (REF_AREA).
• Parcours recommandé en trois étapes : discover_dataflows, puis get_constraints, puis get_data avec les filtres de dimensions.
• Double cache (mémoire et disque, durées configurables) et limite de quatre appels par minute vers l’API de l’ISTAT.
• Skill SKILL.md fourni dans skills/istat-mcp, que le README recommande d’installer pour réduire les erreurs et les appels inutiles.
• Configuration documentée pour Claude Desktop, Claude Code, Gemini CLI, VS Code et Codex CLI, plus un mode HTTP optionnel avec Docker et Helm.

Pour qui

Pour qui veut qu’un assistant IA réponde à partir de statistiques publiées par l’ISTAT (le README cite par exemple la population et l’agriculture) sans appeler l’API SDMX à la main. Une base technique (Python, configuration d’un client MCP) est nécessaire.

Installation

Cloner le dépôt, créer l’environnement avec uv (ou pip ; Python 3.11 minimum), puis déclarer le serveur dans la configuration du client MCP en pointant vers l’interpréteur du dossier .venv. Le README recommande aussi d’installer le skill fourni.

git clone https://github.com/ondata/istat_mcp_server.git

uv sync

claude mcp add -s user istat -- "/path/to/istat_mcp_server/.venv/bin/python" -m istat_mcp_server

Lire le README sur GitHub

Points d’attention

• Le README indique qu’il n’y a pas de versions publiées : ce qui est fusionné dans main est ce que les utilisateurs installent.
• Le serveur n’effectue que quatre appels par minute vers l’API de l’ISTAT, avec mise en file d’attente ; certaines réponses de contraintes peuvent être lentes (délai configurable).
• Les exemples de configuration doivent utiliser l’interpréteur du dossier .venv créé à l’installation ; un python3 générique du PATH ne peut généralement pas importer le paquet.

Utilisable par un agent ?

Prêt pour un agent

Le dépôt est un serveur MCP et fournit un skill SKILL.md dans skills/istat-mcp. Le README donne des exemples de configuration pour Claude Desktop, Claude Code, Gemini CLI, VS Code et Codex CLI. Aucun AGENTS.md ni CLAUDE.md à la racine.