🧮 irpp-mcp — Simulateur IRPP officiel DGFiP

Serveur MCP Python qui calcule l'impôt sur le revenu français à partir du code source officiel DGFiP, compilé via Mlang (OCamlPro/DGFiP). Calcul 100% local, zéro appel réseau.

Revenus couverts : 2023 (déclaration 2024). Voir Limitations.

Architecture

Sources DGFiP (langage M)  →  Mlang (OCamlPro/DGFiP)  →  C (~55 Mo)  →  irpp_calc
                                                                           ↓
                                                                    irpp_mcp.py (MCP)
                                                                           ↓
                                                                      Claude Code

Arborescence attendue

Avant de commencer, créer un répertoire de travail. À la fin de l'installation, la structure sera :

~/impots/
├── calculette-ir-master/           ← sources DGFiP téléchargées (étape 1)
│   └── sources2023m_8_0/
├── mlang-src/                      ← compilateur Mlang cloné (étape 2)
│   ├── _build/default/src/main.exe
│   ├── m_ext/2023/
│   └── examples/dgfip_c/ml_primitif/c_driver/
│       └── irdata.c
├── output/                         ← C générés (étape 3) + binaire (étape 4)
│   ├── irpp_driver.c               ← fourni dans ce repo
│   ├── Makefile                    ← fourni dans ce repo
│   └── irpp_calc                   ← binaire compilé
└── irpp-mcp/                       ← ce repo (cloné en premier)
    └── irpp_mcp.py

Commencer par cloner ce repo :

mkdir ~/impots && cd ~/impots
git clone https://github.com/erwanpaccard/irpp-mcp.git

Installation rapide (binaire pré-compilé)

Si vous êtes sous Linux x86-64 ou WSL (Ubuntu 22.04+), vous pouvez sauter les étapes 1 à 4 et télécharger directement le binaire pré-compilé :

mkdir -p ~/impots/output
wget https://github.com/erwanpaccard/irpp-mcp/releases/download/v1.0.0/irpp_calc \
     -O ~/impots/output/irpp_calc
chmod +x ~/impots/output/irpp_calc

# Tester
printf "V_0AC=1\nTSHALLOV=50000.00\n" | ~/impots/output/irpp_calc
# → {"IINET": 6786.00, "NBPT": 1.00, "RNI": 45000.00, ...}

Puis passer directement à l'étape 5.

Installation complète (compilation depuis les sources)

Prérequis

• WSL (Ubuntu 22.04 recommandé) — nécessaire pour compiler et exécuter le binaire Linux
• Python 3.11+ avec pip
• gcc, make, git, opam, unzip

Étape 1 — Sources DGFiP (langage M)

Le code fiscal officiel est publié par la DGFiP sur Adullact sous licence CeCILL 2.1. Aucun compte requis.

cd ~/impots
curl -L "https://gitlab.adullact.net/dgfip/impots-nationaux-revenu-patrimoine-particuliers/calculette-ir/-/archive/master/calculette-ir-master.zip" \
     -o calculette-ir-master.zip
unzip calculette-ir-master.zip

Dossier utile : calculette-ir-master/sources2023m_8_0/

Étape 2 — Compiler Mlang (~15 min)

cd ~/impots
sudo apt install libgmp-dev libmpfr-dev git opam bubblewrap unzip bzip2 patch

git clone https://gitlab.adullact.net/dgfip/impots-nationaux-revenu-patrimoine-particuliers/Mlang.git mlang-src
cd mlang-src

# Correctif obligatoire (version non substituée dans les fichiers opam)
sed -i 's/%%VERSION%%/0.0.1/g' mlang.opam irj_checker.opam

OPAMYES=1 make init
make build

Binaire produit : mlang-src/_build/default/src/main.exe

Étape 3 — Générer les fichiers C depuis les sources M

cd ~/impots/mlang-src
eval $(opam env --switch=$(pwd) --set-switch)

./_build/default/src/main.exe \
  -A iliad \
  --display_time \
  --precision double \
  --mpp_function=enchainement_primitif \
  --income-year=2023 \
  --dgfip_options=-g,-O,-k4,-m2023,-X \
  --backend dgfip_c \
  --output ../output/irpp_2023.c \
  $(find ../calculette-ir-master/sources2023m_8_0 -name 'tgvI.m') \
  $(find ../calculette-ir-master/sources2023m_8_0 -name 'errI.m') \
  $(find ../calculette-ir-master/sources2023m_8_0 -name '*.m' \
    ! -name 'err*.m' ! -name 'tgv*.m' ! -name 'cibles.m' | sort) \
  m_ext/2023/cibles.m m_ext/2023/codes_1731.m m_ext/2023/commence_par_5.m \
  m_ext/2023/commence_par_7.m m_ext/2023/commence_par_H.m \
  m_ext/2023/correctif.m m_ext/2023/main.m

tgvI.m doit être passé en premier — il déclare l'application iliad.

Résultat : ~55 Mo de fichiers C dans ~/impots/output/.

Étape 4 — Compiler le binaire

irpp_driver.c et Makefile sont déjà dans output/ (fournis par ce repo). Copier depuis le repo :

cp ~/impots/irpp-mcp/output/irpp_driver.c ~/impots/output/
cp ~/impots/irpp-mcp/output/Makefile ~/impots/output/

cd ~/impots/output
make CDRIVER=../mlang-src/examples/dgfip_c/ml_primitif/c_driver

Tester :

printf "V_0AC=1\nTSHALLOV=50000.00\n" | ./irpp_calc
# → {"IINET": 6786.00, "NBPT": 1.00, "RNI": 45000.00, ...}

Étape 5 — Installer le serveur MCP

pip install mcp pydantic

Vérifier que BINARY_PATH dans irpp_mcp.py pointe vers le binaire compilé. Par défaut :

BINARY_PATH = Path(__file__).parent.parent / "output" / "irpp_calc"
# → ~/impots/output/irpp_calc  ✓ si vous avez suivi l'arborescence ci-dessus

Étape 6 — Configurer Claude Code

Créer .mcp.json à la racine du projet Claude Code :

{
  "mcpServers": {
    "irpp-mcp": {
      "command": "python3",
      "args": ["/home/user/impots/irpp-mcp/irpp_mcp.py"]
    }
  }
}

Sur Windows (invocation via WSL) :

{
  "mcpServers": {
    "irpp-mcp": {
      "command": "wsl",
      "args": ["-e", "python3", "/mnt/c/Users/vous/impots/irpp-mcp/irpp_mcp.py"]
    }
  }
}

Adapter le chemin à votre arborescence. Trouver le chemin Python : which python3 dans WSL.

Utilisation

L'outil MCP irpp_calculer_ir accepte les paramètres du formulaire 2042 :

Variables retournées : IINET (impôt net), NBPT (parts), RNI (revenu net imposable), REVKIRE (revenu fiscal de référence), IRNET, IAVIM, IRTOTAL.

Utilisation avec le skill impôts

Le skill erwanpaccard/impots détecte automatiquement ce serveur MCP et l'utilise pour les simulations IR — les calculs s'appuient alors sur le moteur DGFiP officiel plutôt que sur des estimations LLM.

Limitations

• Revenus 2023 uniquement : les sources 2024 (sources2024m_3_13) sont incompatibles avec la version actuelle de Mlang (variable GLOBAL.REPRCM non résolue dans le contexte correctif).
• micro_bnc_declarant1 (case 5TE) : calcule REVKIRE correctement mais donne IINET=0. Workaround : passer les recettes × 66 % dans bnc_declarant1 (5QC).
• Binaire Linux uniquement : sur Windows, l'invocation passe automatiquement par WSL.

Sources et licences