Skip to main content
Glama
irpp-mcp

irpp-mcp

by erwanpaccard

🧮 irpp-mcp — Offizieller DGFiP IRPP-Simulator

Ein Python-MCP-Server, der die französische Einkommensteuer auf Basis des offiziellen DGFiP-Quellcodes berechnet, kompiliert über Mlang (OCamlPro/DGFiP). 100 % lokale Berechnung, null Netzwerkaufrufe.

Abgedeckte Einkünfte: 2023 (Steuererklärung 2024). Siehe Einschränkungen.


Architektur

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

Related MCP server: itr-mcp

Erwartete Verzeichnisstruktur

Erstellen Sie vor Beginn ein Arbeitsverzeichnis. Am Ende der Installation sieht die Struktur wie folgt aus:

~/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

Beginnen Sie mit dem Klonen dieses Repos:

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

Schnellinstallation (vorkompiliertes Binärprogramm)

Wenn Sie Linux x86-64 oder WSL (Ubuntu 22.04+) verwenden, können Sie die Schritte 1 bis 4 überspringen und das vorkompilierte Binärprogramm direkt herunterladen:

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, ...}

Fahren Sie dann direkt mit Schritt 5 fort.


Vollständige Installation (Kompilierung aus den Quellen)

Voraussetzungen

  • WSL (Ubuntu 22.04 empfohlen) — erforderlich, um das Linux-Binärprogramm zu kompilieren und auszuführen

  • Python 3.11+ mit pip

  • gcc, make, git, opam, unzip


Schritt 1 — DGFiP-Quellen (M-Sprache)

Der offizielle Steuer-Code wird von der DGFiP auf Adullact unter der CeCILL 2.1-Lizenz veröffentlicht. Kein Konto erforderlich.

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

Nützlicher Ordner: calculette-ir-master/sources2023m_8_0/


Schritt 2 — Mlang kompilieren (~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

Erzeugtes Binärprogramm: mlang-src/_build/default/src/main.exe


Schritt 3 — C-Dateien aus den M-Quellen generieren

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 muss zuerst übergeben werden — es deklariert die Anwendung iliad.

Ergebnis: ~55 MB an C-Dateien in ~/impots/output/.


Schritt 4 — Binärprogramm kompilieren

irpp_driver.c und Makefile befinden sich bereits in output/ (bereitgestellt durch dieses Repo). Kopieren Sie diese aus dem 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

Testen:

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

Schritt 5 — MCP-Server installieren

pip install mcp pydantic

Stellen Sie sicher, dass BINARY_PATH in irpp_mcp.py auf das kompilierte Binärprogramm zeigt. Standardmäßig:

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

Schritt 6 — Claude Code konfigurieren

Erstellen Sie .mcp.json im Stammverzeichnis des Claude Code-Projekts:

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

Unter Windows (Aufruf über WSL):

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

Passen Sie den Pfad an Ihre Verzeichnisstruktur an. Finden Sie den Python-Pfad: which python3 in WSL.


Verwendung

Das MCP-Tool irpp_calculer_ir akzeptiert die Parameter des Formulars 2042:

Parameter

Feld 2042

Beschreibung

situation

—

celibataire / marie / pacse / divorce / veuf

salaires_declarant1

1AJ

Steuerpflichtige Nettolöhne Steuerpflichtiger 1

salaires_declarant2

1BJ

Steuerpflichtige Nettolöhne Steuerpflichtiger 2

pensions_declarant1

1AS

Renten, Pensionen, Annuitäten Steuerpflichtiger 1

pensions_declarant2

1BS

Renten, Pensionen, Annuitäten Steuerpflichtiger 2

bnc_declarant1

5QC

BNC (nicht-kommerzielle Einkünfte) professionell, normales System

micro_foncier

4BE

Micro-foncier Bruttoeinnahmen

dividendes

2DC

Dividenden (40 % Freibetrag)

plus_values

3VG

Kapitalgewinne aus beweglichem Vermögen

nb_enfants_charge

0CF

Unterhaltsberechtigte minderjährige Kinder

nb_enfants_alternee

0CH

Kinder bei alternierendem Wohnsitz

per_declarant1

6NS

Abzugsfähige PER-Beiträge Steuerpflichtiger 1

per_declarant2

6NT

Abzugsfähige PER-Beiträge Steuerpflichtiger 2

pension_alimentaire

6GI

An volljähriges Kind gezahlte Unterhaltszahlung

revenus_fonciers_reels

4BA

Netto-Immobilieneinkünfte, reales System

annee_naissance_declarant1

—

Geburtsjahr Steuerpflichtiger 1

response_format

—

markdown (Standard) oder json

Zurückgegebene Variablen: IINET (Netto-Steuer), NBPT (Anteile), RNI (steuerpflichtiges Nettoeinkommen), REVKIRE (Referenz-Steuereinkommen), IRNET, IAVIM, IRTOTAL.


Verwendung mit dem Impôts-Skill

Der Skill erwanpaccard/impots erkennt diesen MCP-Server automatisch und verwendet ihn für IR-Simulationen — die Berechnungen basieren dann auf der offiziellen DGFiP-Engine anstelle von LLM-Schätzungen.


Einschränkungen

  • Nur Einkommen 2023: Die Quellen 2024 (sources2024m_3_13) sind mit der aktuellen Version von Mlang inkompatibel (Variable GLOBAL.REPRCM im Kontext correctif nicht aufgelöst).

  • micro_bnc_declarant1 (Feld 5TE): Berechnet REVKIRE korrekt, ergibt aber IINET=0. Workaround: Einnahmen × 66 % in bnc_declarant1 (5QC) eingeben.

  • Nur Linux-Binärprogramm: Unter Windows erfolgt der Aufruf automatisch über WSL.


Quellen und Lizenzen

Komponente

Quelle

Lizenz

DGFiP-Quellen (Einkommen 2023)

Adullact — calculette-ir

CeCILL 2.1

Mlang-Compiler

Mlang (Adullact)

GPL-3.0

irpp_driver.c + irpp_mcp.py

Dieses Repository

MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      F
      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.
      6
      12
      1
      MIT
    • 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.
      16
      461 npm
      10
      MIT
    • F
      license
      A
      quality
      D
      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.
      13
      2
      -
    • A
      license
      Not graded
      quality
      D
      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.
      66 PyPI
      MIT