INS MCP

Qu’est-ce que c’est

INS MCP est un serveur local implémentant le Model Context Protocol (MCP), le standard ouvert par lequel les assistants IA appellent des outils externes. Il connecte un client compatible MCP (Claude Desktop, Cursor, VS Code, etc.) au portail de statistiques nationales de la Tunisie — le portail de données de l’Institut National de la Statistique (INS), à l’adresse dataportal.ins.tn, bâti sur la plateforme propriétaire Prognoz. Le portail contient des cubes de séries temporelles couvrant les comptes nationaux, le recensement de 2014, les projections de population, l’emploi, les conditions des ménages et le commerce extérieur.

L’API du portail fonctionne en XML, avec des métadonnées difficiles et piégeuses. La raison d’être d’INS MCP est de prendre tout cela en charge : ses outils acceptent des paramètres structurés et renvoient du JSON propre, de sorte que l’IA ne voit jamais une balise XML. Il s’adresse aux chercheurs, data scientists, économistes et journalistes travaillant avec les statistiques officielles tunisiennes. INS MCP est un projet indépendant ; il n’est ni approuvé par l’INS ni affilié à l’INS.

Comment ça fonctionne

L’utilisateur pose une question en langage naturel. Le client IA, guidé par les descriptions des outils, les enchaîne : il cherche le bon cube statistique dans le catalogue, explore ou recherche les dimensions de ce cube pour résoudre les codes numériques de l’indicateur et de la région voulus, puis demande les observations pour cette sélection. Le serveur construit la requête XML, appelle le portail INS en direct, analyse et nettoie la réponse, et renvoie des enregistrements JSON propres — chacun avec sa période, sa valeur, son unité et un bloc d’attribution de source obligatoire. L’identité passe toujours par les codes, jamais par les libellés bruts du portail, et trois signaux de disponibilité distincts (période déclarée, indicateur de présence de données, couverture réelle) garantissent l’honnêteté de la réponse.

Cas d’usage

• Recherche académique : un·e économiste demande les projections de population de la Tunisie à l’horizon 2044 par gouvernorat et par sexe, et obtient une série propre et sourcée sans écrire de XML Prognoz à la main.
• Journalisme d’investigation : un·e journaliste demande le PIB aux prix du marché sur 2014–2017, ou la valeur ajoutée par secteur, et reçoit des chiffres exacts avec la référence de source INS prête à publier.
• Politique publique : un·e analyste interroge le recensement de 2014 (population par gouvernorat, équipement des ménages, emploi), et le serveur signale quels cubes du recensement sont renseignés ou publiés-mais-vides, pour ne pas perdre de temps sur des coquilles vides.

Démo — exemple illustratif

{
"source_id": "OBJ5259889",
"observations": [
  { "period": "2014", "frequency": "annual", "value": 80865.5 },
  { "period": "2015", "frequency": "annual", "value": 84689.2 },
  { "period": "2016", "frequency": "annual", "value": 89792.2 },
  { "period": "2017", "frequency": "annual", "value": 96324.7 }
],
"coverage": { "start": "2014", "end": "2017", "count": 4 },
"attribution": {
  "producer": "Institut National de la Statistique (INS), Tunisie",
  "source_url": "http://dataportal.ins.tn/",
  "license_url": "https://www.ins.tn/conditions-utilisation",
  "last_updated": "2017-02-27",
  "disclaimer": "Fourni tel quel ; pas une publication officielle de l'INS et non approuvé par l'INS."
}
}

Statut et feuille de route

INS MCP est open source sous licence MIT et auto-hébergé : aucun endpoint distant n’est maintenu ; il s’exécute comme un processus stdio local lancé par le client MCP de l’utilisateur — le même modèle qu’agridata MCP. Le dépôt GitHub est la source unique pour l’installation, le code et les évolutions : clonez-le, créez un environnement virtuel, lancez pip install -e ., puis python -m ins_mcp. Les prochaines étapes prévues : une installation packagée à plus faible friction pour les utilisateurs non techniques, une résilience hors-ligne optionnelle, une découverte améliorée (translittération et alias arabes des noms de lieux), et des tests de bout en bout élargis.

Rapport technique

Version d’archive citable faisant foi : Gasmi, T. (2026). ins-tunisia-mcp: An MCP Server for Conversational Access to Tunisia’s National Statistics (0.1.0). Zenodo. https://doi.org/10.5281/zenodo.20738616

Code source : github.com/tanitdata/ins-tunisia-mcp