irpp-mcp
🧮 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 CodeRelated 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.pyComience clonando este repositorio:
mkdir ~/impots && cd ~/impots
git clone https://github.com/erwanpaccard/irpp-mcp.gitInstalació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
pipgcc,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.zipCarpeta ú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 buildBinario 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.mdebe pasarse primero — declara la aplicacióniliad.
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_driverProbar:
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 pydanticVerifique 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-dessusPaso 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 python3en WSL.
Uso
La herramienta MCP irpp_calculer_ir acepta los parámetros del formulario 2042:
Parámetro | Casilla 2042 | Descripción |
| — |
|
| 1AJ | Salarios netos imponibles declarante 1 |
| 1BJ | Salarios netos imponibles declarante 2 |
| 1AS | Pensiones, jubilaciones, rentas declarante 1 |
| 1BS | Pensiones, jubilaciones, rentas declarante 2 |
| 5QC | BNC profesionales régimen normal |
| 4BE | Micro-foncier ingresos brutos |
| 2DC | Dividendos (reducción 40 %) |
| 3VG | Plusvalías mobiliarias |
| 0CF | Hijos menores a cargo |
| 0CH | Hijos en residencia compartida |
| 6NS | Cotizaciones PER deducibles declarante 1 |
| 6NT | Cotizaciones PER deducibles declarante 2 |
| 6GI | Pensión alimenticia pagada a hijo mayor de edad |
| 4BA | Ingresos inmobiliarios netos régimen real |
| — | Año de nacimiento declarante 1 |
| — |
|
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 (variableGLOBAL.REPRCMno resuelta en el contextocorrectif).micro_bnc_declarant1(casilla 5TE): calculaREVKIREcorrectamente pero daIINET=0. Solución: pasar los ingresos × 66 % enbnc_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) | CeCILL 2.1 | |
Compilador Mlang | GPL-3.0 | |
| Este repositorio | MIT |
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Exact French tax & payroll calculations for AI agents: income tax (impôt sur le revenu: parts, quotient familial, décote, TMI), micro-entrepreneur URSSAF contributions (ACRE, versement libératoire) with an optional VAT franchise check (franchise en base de TVA: must I charge VAT?), and gross-to-net salary with employer cost — CDI or CDD (prime de précarité, congés payés), full-time or part-time. Missing information? Your agent gets, for free, the exact questions to ask the user (in French, with types and allowed values) in a single round trip. Deterministic, no LLM: matches all 7,095 values of the official DGFiP tax tables, 60 cases from the official simulators and the official worked examples of the tax doctrine (BOFiP). Unsupported cases are refused for free; you pay $0.005 in USDC via x402 only when the calculation succeeds. Free catalogue tool: list_france_calculators.
The first fiscal MCP server for Spain: IAE/CNAE 2025, AEAT modelos, IRPF/IVA, RETA quota.
Brazil tax reform simulator for AI (CBS/IBS/IS) on Receita Federal's official open-source code.
TaxSort — Tollbooth-monetized MCP server for personal tax transaction classification
Related MCP Servers
- AlicenseAqualityFmaintenanceA local MCP server that enables Claude to answer Norwegian tax questions with actual calculations, covering income, wealth, stocks, funds, real estate, crypto, and more.6121MIT
- AlicenseAqualityBmaintenanceLocal-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.16461 npm10MIT
- FlicenseAqualityDmaintenanceMCP server for the Swiss federal tax calculator, providing income, wealth, inheritance, and corporate tax figures for all Swiss municipalities and tax years 2010-2026.132-
- AlicenseNot gradedqualityDmaintenanceA 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 PyPIMIT