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 — Simulador IRPP oficial DGFiP

Servidor MCP de Python que calcula el impuesto sobre la renta francés a partir del código fuente oficial de la DGFiP, compilado mediante Mlang (OCamlPro/DGFiP). Cálculo 100% local, cero llamadas de red.

Ingresos cubiertos: 2023 (declaración 2024). Ver Limitaciones.

Arquitectura

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

Related MCP server: itr-mcp

Estructura de directorios esperada

Antes de comenzar, cree un directorio de trabajo. Al finalizar la instalación, la estructura será:

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

Comience clonando este repositorio:

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

Instalación rápida (binario precompilado)

Si utiliza Linux x86-64 o WSL (Ubuntu 22.04+), puede saltarse los pasos 1 a 4 y descargar directamente el binario precompilado:

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

Luego pase directamente al paso 5.

Instalación completa (compilación desde las fuentes)

Requisitos previos

WSL (se recomienda Ubuntu 22.04) — necesario para compilar y ejecutar el binario de Linux
Python 3.11+ con pip
gcc, make, git, opam, unzip

Paso 1 — Fuentes de la DGFiP (lenguaje M)

El código fiscal oficial es publicado por la DGFiP en Adullact bajo licencia CeCILL 2.1. No se requiere cuenta.

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

Carpeta útil: calculette-ir-master/sources2023m_8_0/

Paso 2 — Compilar 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

Binario producido: mlang-src/_build/default/src/main.exe

Paso 3 — Generar los archivos C desde las fuentes 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 debe pasarse primero — declara la aplicación iliad.

Resultado: ~55 MB de archivos C en ~/impots/output/.

Paso 4 — Compilar el binario

irpp_driver.c y Makefile ya están en output/ (proporcionados por este repositorio). Copiar desde el repositorio:

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

Probar:

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

Paso 5 — Instalar el servidor MCP

pip install mcp pydantic

Verifique que BINARY_PATH en irpp_mcp.py apunte al binario compilado. Por defecto:

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

Paso 6 — Configurar Claude Code

Cree .mcp.json en la raíz del proyecto Claude Code:

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

En Windows (invocación mediante WSL):

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

Adapte la ruta a su estructura de directorios. Encuentre la ruta de Python: which python3 en WSL.

Uso

La herramienta MCP irpp_calculer_ir acepta los parámetros del formulario 2042:

Parámetro	Casilla 2042	Descripción
`situation`	—	`celibataire` / `marie` / `pacse` / `divorce` / `veuf`
`salaires_declarant1`	1AJ	Salarios netos imponibles declarante 1
`salaires_declarant2`	1BJ	Salarios netos imponibles declarante 2
`pensions_declarant1`	1AS	Pensiones, jubilaciones, rentas declarante 1
`pensions_declarant2`	1BS	Pensiones, jubilaciones, rentas declarante 2
`bnc_declarant1`	5QC	BNC profesionales régimen normal
`micro_foncier`	4BE	Micro-foncier ingresos brutos
`dividendes`	2DC	Dividendos (reducción 40 %)
`plus_values`	3VG	Plusvalías mobiliarias
`nb_enfants_charge`	0CF	Hijos menores a cargo
`nb_enfants_alternee`	0CH	Hijos en residencia compartida
`per_declarant1`	6NS	Cotizaciones PER deducibles declarante 1
`per_declarant2`	6NT	Cotizaciones PER deducibles declarante 2
`pension_alimentaire`	6GI	Pensión alimenticia pagada a hijo mayor de edad
`revenus_fonciers_reels`	4BA	Ingresos inmobiliarios netos régimen real
`annee_naissance_declarant1`	—	Año de nacimiento declarante 1
`response_format`	—	`markdown` (por defecto) o `json`

Variables devueltas: IINET (impuesto neto), NBPT (partes), RNI (ingreso neto imponible), REVKIRE (ingreso fiscal de referencia), IRNET, IAVIM, IRTOTAL.

Uso con la skill impôts

La skill erwanpaccard/impots detecta automáticamente este servidor MCP y lo utiliza para las simulaciones de IR — los cálculos se basan entonces en el motor oficial de la DGFiP en lugar de estimaciones de LLM.

Limitaciones

Solo ingresos 2023: las fuentes 2024 (sources2024m_3_13) son incompatibles con la versión actual de Mlang (variable GLOBAL.REPRCM no resuelta en el contexto correctif).
micro_bnc_declarant1 (casilla 5TE): calcula REVKIRE correctamente pero da IINET=0. Solución: pasar los ingresos × 66 % en bnc_declarant1 (5QC).
Solo binario Linux: en Windows, la invocación pasa automáticamente por WSL.

Fuentes y licencias

Componente	Fuente	Licencia
Fuentes DGFiP (ingresos 2023)	Adullact — calculette-ir	CeCILL 2.1
Compilador Mlang	Mlang (Adullact)	GPL-3.0
`irpp_driver.c` + `irpp_mcp.py`	Este repositorio	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