Dichiarino MCP

   

MCP（模型上下文协议）服务器，作为编译意大利语的智能助手 型号 730 预编译 -预先填写的年度所得税申报表。

______________________________________________________________________

Dichiarino是什么？

Dichiarino是一种 MCP服务器 它使任何兼容的人工智能助手（Claude Desktop、Cursor等）都能深入了解意大利税收制度和730表格的计算工具。它嵌入了官方财政规则、IRPEF税率和扣除限额，因此人工智能可以指导您完成年度纳税申报。

注： Agenzia delle Entrate没有为730预编译提供公共API。Dichiarino是一个知识+计算引擎，它无法为您提交报税表。始终与合格的专业人员（CAF、Commerciata、consulente del lavoro）核实结果。

特性

资源：

• dichiarino://aliquote/{anno} -IRPEF等级和费率
• dichiarino://quadri/{nome} -每个Quadro的完整说明
• dichiarino://scadenze/{anno} -关键截止日期
• dichiarino://regioni -区域附加费表
• dichiarino://detrazioni -全额扣除限额表

代理技能

除了MCP服务器，Dichiarino还提供了一套便携式 代理技能 在 skills/ 文件夹-与Claude、Cursor兼容的独立指令包， 以及任何agentskills.io支持的工具。它们在没有MCP服务器的情况下工作，但在连接后会得到增强。

看 skills/README.md 有关安装说明。

需求

• Python 3.11+
• 紫外线 （推荐）或pip

安装

# Clone the repo
git clone https://github.com/gsaccardi/dichiarino-mcp.git
cd dichiarino-mcp

# Install with uv
uv sync

用法

使用克劳德桌面

添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "dichiarino": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/dichiarino-mcp",
        "run",
        "dichiarino"
      ]
    }
  }
}

使用Cursor或其他MCP客户端

添加 .cursor/mcp.json （项目）或 ~/.cursor/mcp.json （全球）：

{
  "mcpServers": {
    "dichiarino": {
      "command": "uv",
      "args": ["--directory", "/path/to/dichiarino-mcp", "run", "dichiarino"]
    }
  }
}

直接运行

uv run dichiarino
# or
uv run python -m dichiarino.main

交互示例

连接到Claude Desktop后：

You: Quanto IRPEF devo pagare su un reddito di 35.000€?

Claude: [calls calcola_irpef + calcola_detrazione_lavoro]
        IRPEF lorda: 8.890€
        Detrazione lavoro: 1.565€ + bonus 65€
        IRPEF netta stimata: 7.260€

You: Ho speso 1.200€ dal medico quest'anno. Cosa posso detrarre?

Claude: [calls calcola_oneri]
        Spese sanitarie: 1.200€ - franchigia 129,11€ = 1.070,89€ x 19% = 203,47€
        Documenti necessari: fatture mediche, scontrini farmacia con CF

You: Quali quadri devo compilare? Ho lavoro dipendente, mutuo, e figli under 21.

Claude: [calls genera_checklist_730]
        Quadri: Frontespizio, C (lavoro), E (mutuo 19% su max 4.000€)
        ⚠️ I figli under 21 non generano detrazione - coperti dall'Assegno Unico Universale
        Documenti: CU datore, quietanza interessi banca, contratto mutuo

发展

# Install dev dependencies
uv sync --dev

# Run tests
uv run pytest

# Lint
uv run ruff check src/ tests/

# Type check
uv run mypy src/

项目结构

src/dichiarino/
├── main.py              # Entry point
├── server.py            # MCP server setup + registration
├── types.py             # Domain types
├── calculators/         # Pure calculation functions
│   ├── irpef.py
│   ├── detrazioni_lavoro.py
│   ├── detrazioni_familiari.py
│   ├── oneri.py
│   └── addizionali.py
├── validators/
│   └── codice_fiscale.py
├── data/                # Static fiscal data (2024)
│   ├── aliquote_irpef.py
│   ├── addizionali_regionali.py
│   ├── limiti_detrazioni.py
│   └── istruzioni_quadri.py
├── tools/               # MCP tool handlers
└── resources/           # MCP resource handlers

tests/
├── calculators/         # Unit tests for fiscal math
├── validators/          # Codice fiscale tests
└── integration/         # Full MCP server integration tests

纳税年度覆盖范围

归因

该项目根据 Apache许可证2.0. 如果您重新分发此软件或衍生作品，您必须包括 通知 归档并保留以下属性：

由Dichiarino提供技术支持https://github.com/gsaccardi/dichiarino-mcp

看 许可证 和 通知 完整条款。

免责声明

所提供的财务计算仅供参考，不构成专业的税务或法律建议。在提交之前，请务必与合格的专业人员核实您的纳税申报表。作者对财政立法中的错误或变化不承担任何责任。

______________________________________________________________________

Made with ❤️ for Italian taxpayers