金大哥 - french-tax-mcp MCP 详情

article

README

🚀 法国税务MCP服务器

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

🚀 快速开始

本MCP服务器能为AI助手提供法国个人所得税的计算功能，让AI助手可以根据不同的情况给出相应的税务计算结果。

✨ 主要特性

个人所得税计算：根据净应税收入和家庭构成（家庭系数）计算法国所得税（impôt sur le revenu）。
税率区间查询：从法国政府官方渠道获取当前的所得税税率区间。
动态数据获取：使用网页抓取技术从service - public.fr获取最新的税务信息，若抓取失败则使用硬编码数据作为备用。

📦 安装指南

# 通过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：家庭系数（quotient familial），默认为1.0。
year：纳税年度（可选，默认为当前年份）。示例：

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

`get_tax_brackets`

获取当前法国所得税税率区间。参数：

year：纳税年度（可选，默认为当前年份）。示例：

当前法国的所得税税率区间是多少？

💻 使用示例

基础用法

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

高级用法

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

税率区间查询用法

查看2024年法国的所得税税率区间

🔧 技术细节

数据来源

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

📄 许可证

本项目采用Apache License 2.0许可协议，详情请参阅LICENSE文件。

🔗 相关链接

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

⚠️ 注意事项

功能限制

目前仅支持法国居民的个人所得税计算。
网页抓取可能偶尔失败（这种情况下会使用备用数据）。
税务计算仅用于参考。

开发相关

本地开发

# 克隆仓库
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/

法律声明

本工具仅提供信息参考，不构成专业税务建议。如需针对个人情况的建议，请咨询注册会计师或税务顾问。税务信息来源于法国政府官方网站，但可能未反映最新的税法变化，请始终与官方来源核实计算结果。

未来规划

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

[ ] LMNP（非专业带家具出租）：带家具出租税计算。
[ ] 皮内尔投资：房地产投资税收优惠。
[ ] 微型企业/个体经营者：企业税计算。
[ ] 公司税：公司税计算。
[ ] 财产税：房地产税信息。
[ ] 社会费用：社会保障缴款。
[ ] 税务表格：详细的表格指导和填写协助。
[ ] 官方API集成：用官方政府API替代网页抓取。

french-tax-mcp