de en es fr ja ko ru zh

irpp-mcp

Name: irpp-mcp
Author: erwanpaccard

by erwanpaccard

Overview Schema Source Related Servers Discussions Admin

Python

Local

🧮 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

Related MCP server: itr-mcp

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 :

Paramètre	Case 2042	Description
`situation`	—	`celibataire` / `marie` / `pacse` / `divorce` / `veuf`
`salaires_declarant1`	1AJ	Salaires nets imposables déclarant 1
`salaires_declarant2`	1BJ	Salaires nets imposables déclarant 2
`pensions_declarant1`	1AS	Pensions, retraites, rentes déclarant 1
`pensions_declarant2`	1BS	Pensions, retraites, rentes déclarant 2
`bnc_declarant1`	5QC	BNC professionnels régime normal
`micro_foncier`	4BE	Micro-foncier recettes brutes
`dividendes`	2DC	Dividendes (abattement 40 %)
`plus_values`	3VG	Plus-values mobilières
`nb_enfants_charge`	0CF	Enfants mineurs à charge
`nb_enfants_alternee`	0CH	Enfants en résidence alternée
`per_declarant1`	6NS	Cotisations PER déductibles déclarant 1
`per_declarant2`	6NT	Cotisations PER déductibles déclarant 2
`pension_alimentaire`	6GI	Pension alimentaire versée à enfant majeur
`revenus_fonciers_reels`	4BA	Revenus fonciers nets régime réel
`annee_naissance_declarant1`	—	Année de naissance déclarant 1
`response_format`	—	`markdown` (défaut) ou `json`

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

Composant	Source	Licence
Sources DGFiP (revenus 2023)	Adullact — calculette-ir	CeCILL 2.1
Compilateur Mlang	Mlang (Adullact)	GPL-3.0
`irpp_driver.c` + `irpp_mcp.py`	Ce dépôt	MIT

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive

ResponsivenessNo issues

Resources

GitHub Repository

Need Help?

Related Servers

Related MCP Connectors

Conversor IAE-CNAE A
io.github.conversoriaecnae
The first fiscal MCP server for Spain: IAE/CNAE 2025, AEAT modelos, IRPF/IVA, RETA quota.
Finance Legal & Compliance Government Data
2
taxsort-mcp B
io.github.lonniev
TaxSort — Tollbooth-monetized MCP server for personal tax transaction classification
Finance AI & Machine Learning
872
quaderno A
io.usefulapi
MCP server for Quaderno — tax-rate calculation, invoices, contacts, products, receipts & expenses.
Finance Payments & Billing
232
tax-retirement A
io.github.herve-coulon
Calcul fiscal (IR, IFI, PER, plus-value) et retraite français — 32 régimes, sourcé et daté.
Finance Legal & Compliance
3511

Related MCP Servers

skatt-mcp
Finance Legal & Compliance
ValiantEvers
A
license
A
quality
C
maintenance
A local MCP server that enables Claude to answer Norwegian tax questions with actual calculations, covering income, wealth, stocks, funds, real estate, crypto, and more.
Updated 2 days ago (2026-09-19 19:54 UTC)
12
1
MIT
itr-mcp
Finance Legal & Compliance
Sagargupta16
A
license
A
quality
B
maintenance
Local-first MCP server for Indian income tax computation, enabling users to compute taxes, compare regimes, plan advance tax, and parse Form 26AS without sending data to the cloud.
Updated 11 days ago (2026-09-11 01:41 UTC)
12
6 npm
8
MIT
estv-mcp
Government Data Finance Open Data
noaahh
F
license
A
quality
C
maintenance
MCP server for the Swiss federal tax calculator, providing income, wealth, inheritance, and corporate tax figures for all Swiss municipalities and tax years 2010-2026.
Updated 2 months ago (2026-07-28 11:07 UTC)
13
2
-
taxbrainai-mcp
Finance Legal & Compliance
harshil-projects
A
license
Not graded
quality
C
maintenance
A standalone MCP server for Indian personal income-tax work (ITR-1/2/3/4 + post-filing notices) with 8 deterministic tools, running fully offline with no API keys.
Updated 3 months ago (2026-07-06 00:59 UTC)
MIT