ONEM MCP

Qu’est-ce que c’est

ONEM MCP (onem-tunisia-mcp) est un serveur Model Context Protocol (MCP) qui permet à un client LLM d’interroger en langage naturel les statistiques énergétiques nationales de la Tunisie — production, consommation, échanges, bilans et redevances pour le pétrole, le gaz et l’électricité — à travers trois familles de rapports de l’ONEM (Bilan National de l’Énergie, Memento / Chiffres clés, Conjoncture énergétique), de 2010 à 2026. Les chiffres sont extraits de rapports PDF publics vers un entrepôt DuckDB en lecture seule.

La source est l’Observatoire National de l’Énergie et des Mines (ONEM), Ministère de l’Industrie, des Mines et de l’Énergie, Tunisie (energiemines.gov.tn). Projet indépendant et non officiel, sans aucune affiliation avec l’ONEM ou le Ministère, ni autorisation ni approbation de leur part. Il s’adresse aux chercheurs, journalistes et analystes qui ont besoin des chiffres énergétiques tunisiens avec leurs qualificateurs intacts.

Comment ça fonctionne

L’utilisateur pose une question en langage naturel ; le modèle enchaîne les outils du serveur — search_series pour trouver la bonne série, get_series / get_observation pour la récupérer, compare pour relier les séries sans risque. Chaque valeur renvoyée porte ses qualificateurs (base calorifique PCI/PCS, type de période annuel/cumul, périmètre, géographie) et une provenance au niveau de la cellule (édition source, page, référence de tableau, cellule exacte). Le serveur refuse de comparer des séries incompatibles (par exemple PCI vs PCS, annuel vs cumul) et distingue « hors périmètre / non ingéré » de « aucune donnée n’existe » — de sorte que le modèle ne peut pas blanchir une mauvaise réponse dépouillée de ses qualificateurs.

Cas d’usage

• Recherche académique : un·e économiste de l’énergie demande la production de gaz naturel de la Tunisie sur base PCI, annuelle, 2018–2024, et obtient la série avec base et type de période explicites, sans confusion PCI/PCS.
• Journalisme d’investigation : un·e journaliste demande pourquoi la redevance sur le gaz algérien a baissé début 2026 alors que les achats augmentaient, et le serveur fait apparaître les chiffres en cumul et la note de bas de page documentée sur la régularisation STEG↔État qui explique la contradiction apparente.
• Politique publique : un·e analyste demande les ventes d’électricité en 2024, local contre y compris exportations, et obtient les deux distinctement plutôt qu’un total ambigu unique.

Démo — exemple illustratif

{
"value": 182.0, "unit": "ktep-pci",
"calorific_basis": "PCI", "period_type": "ytd_cumulative", "ytd_cutoff_month": 4,
"data_status": "provisional",
"provenance": {
  "source_id": "conjoncture_2026_04", "source_page": "5",
  "source_ref": "C-T1", "source_cell": "row=Redevance|col=c"
},
"warnings": ["DATA_STATUS=provisional: not a final figure."]
}

Statut et feuille de route

ONEM 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. La base de données construite est livrée avec le dépôt, donc il fonctionne immédiatement après l’installation — aucune connexion au portail au moment des requêtes. Le dépôt GitHub est la source unique pour l’installation, le code et les évolutions. Les prochaines étapes prévues : vérifier les conflits inter-éditions retenus contre les PDF sources, ingérer les familles différées (prix, valeurs et volumes d’échanges, raffinage, exploration), récupérer les éditions différées, et abaisser la barrière de lancement avec un lanceur packagé.

Rapport technique

Un rapport technique (en anglais) documente la conception et l’implémentation du serveur, sous licence CC BY 4.0.

Version d’archive citable faisant foi : Gasmi, T. (2026). onem-tunisia-mcp: A Qualifier-Aware MCP Server over Tunisia’s National Energy Time-Series (1.0.0). Zenodo. https://doi.org/10.5281/zenodo.20942629

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