Irpp

Бесплатно

A Python MCP server that calculates French income tax using the official DGFiP source code compiled locally. It enables accurate tax simulations for 2023 income

автор: erwanpaccard

GitHub

Описание

A Python MCP server that calculates French income tax using the official DGFiP source code compiled locally. It enables accurate tax simulations for 2023 income based on real French tax forms without network calls.

README

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 :

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

Как установить

Добавь это в claude_desktop_config.json и перезапусти Claude Desktop.

{
  "mcpServers": {
    "irpp-mcp": {
      "command": "npx",
      "args": []
    }
  }
}

Irpp

Описание

README

Architecture

Arborescence attendue

Installation rapide (binaire pré-compilé)

Installation complète (compilation depuis les sources)

Prérequis

Étape 1 — Sources DGFiP (langage M)

Étape 2 — Compiler Mlang (~15 min)

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

Étape 4 — Compiler le binaire

Étape 5 — Installer le serveur MCP

Étape 6 — Configurer Claude Code

Utilisation

Utilisation avec le skill impôts

Limitations

Sources et licences

Как установить

Похожие MCP

GitHub

Supabase

Everything

Filesystem

Command Palette

Irpp

Описание

README

Architecture

Arborescence attendue

Installation rapide (binaire pré-compilé)

Installation complète (compilation depuis les sources)

Prérequis

Étape 1 — Sources DGFiP (langage M)

Étape 2 — Compiler Mlang (~15 min)

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

Étape 4 — Compiler le binaire

Étape 5 — Installer le serveur MCP

Étape 6 — Configurer Claude Code

Utilisation

Utilisation avec le skill impôts

Limitations

Sources et licences

Как установить

Похожие MCP

GitHub

Supabase

Everything

Filesystem