🚀 法国税务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替代网页抓取。