法国个人所得税MCP服务器

这是一个提供法国个人所得税计算给AI助手的MCP（模型上下文协议）服务器。

当前功能

此MCP服务器当前支持：

• 个人所得税计算：根据净应税收入和家庭组成（家庭份额）计算法国个人所得税（impôt sur le revenu）
• 税率档次：从官方政府来源获取当前法国个人所得税率档次
• 动态数据：使用web抓取从service-public.fr获取最新的税务信息，并在必要时回退到硬编码的数据

数据源

当前版本使用MarkItDown进行web抓取，从官方法国政府网站（主要是service-public.fr）获取税务信息。未来版本可能会替换为官方API或其他更可靠的数据源。

安装

# 使用pip安装
pip install french-tax-mcp

# 或者推荐使用uv安装
uv pip install french-tax-mcp

MCP配置

添加到您的MCP配置文件（~/.config/mcp/mcp.json或工作区.kiro/settings/mcp.json）：

{
  "mcpServers": {
    "french-tax-mcp": {
      "command": "uvx",
      "args": ["french-tax-mcp@latest"],
      "env": {
        "FASTMCP_LOG_LEVEL": "ERROR"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

可用工具

calculate_income_tax

计算法国个人所得税。

参数：

• net_taxable_income：净应税收入（欧元）
• household_parts：家庭份额数量（默认为1.0）
• year：税年（可选，默认为当前年份）

示例：

计算年薪50,000欧元且有两个孩子的所得税

get_tax_brackets

获取当前法国个人所得税率档次。

参数：

• year：税年（可选，默认为当前年份）

示例：

当前法国的税率档次是什么？

使用示例

基本计算：

年薪45,000欧元需要缴纳多少所得税？

家庭情况：

计算一对夫妇年薪60,000欧元且有一个孩子的所得税

税率档次：

显示2024年的法国税率档次

限制

• 目前仅支持法国居民的个人所得税计算
• web抓取偶尔可能失败（在这种情况下会使用回退数据）
• 税务计算仅供信息参考

TODO - 未来功能

以下功能可能会在未来版本中添加：

• LMNP（Location Meublée Non Professionnelle） - 装修租赁税收计算
• Pinel投资 - 房地产投资税收优惠
• 微型企业/自雇人士 - 商业税收计算
• 公司税 - 公司税收计算
• 房产税 - 房地产税收信息
• 社会保险费 - 社会保险贡献
• 税务表格 - 详细的表格指导和填写帮助
• 官方API集成 - 替换web抓取为官方政府API

开发

本地开发

# 克隆仓库
git clone https://github.com/your-username/french-tax-mcp.git
cd french-tax-mcp

# 在开发模式下安装
pip install -e ".[dev]"

# 在本地运行服务器
python -m french_tax_mcp.server --port 8888

运行测试

# 运行测试
python -m pytest tests/

法律声明

本工具提供的信息仅供信息参考，不构成专业税务建议。针对您个人的情况，请咨询注册会计师或税务顾问。

税务信息来源于官方法国政府网站，但可能不反映最近的税法变化。始终通过官方来源验证计算结果。

许可证

本项目采用Apache许可证2.0 - 详情见LICENSE文件。

链接

• 官方法国税务网站：https://www.impots.gouv.fr
• MCP协议：https://modelcontextprotocol.io/