Skip to main content
Glama
irpp-mcp

irpp-mcp

by erwanpaccard

🧮 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

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