法国个人所得税计算服务

解决什么问题

法国个人所得税按家庭计税单元（parts de quotient familial）分档征收，税档和申报表单会随年份调整。手工核算时，开发者需要同时确认税档、家庭系数、申报字段和政府公告，任何一项过时都会导致结果不可信。这个 MCP 服务器把税额计算与政策查询拆成可调用的工具，让模型能在对话中直接完成计算，而不是让用户去查分散的政府页面。

核心能力与工作流程

• 税额计算：scripts.tools.calculate_income_tax 接收 net_taxable_income、可选的 household_parts 和 year，输出计算结果。
• 政策取数：get_tax_info_from_web、get_tax_brackets、get_form_details、get_tax_procedure、get_tax_deadlines 分别从官方站点取数；search_tax_law、get_tax_article 面向 Légifrance 法条。
• 降级路径：网页抓取失败时可用 get_cached_tax_info，但前提是已取得有效数据。
• 报告输出：generate_tax_report 接收 tax_data 和 topic_name，可选 output_file 与 format。

模型只负责路由和参数提取，实际计算由外部 API 完成。首次使用时必须确认 API 密钥：若 scripts.config.settings.api_key 为空，应先向用户索要，再调用 scripts.config.set_api_key(api_key) 保存。工具返回的 result["raw"] 为 API 原始 JSON，result["success"] 与 result["message"] 用于判断执行状态，展示给用户前再做整理。

适用边界

• API 密钥是硬依赖。缺少密钥时不得自行搜索、估算或编造税档；先通过 AskUserQuestion 询问用户。
• 计算结果依赖外部 API 与输入参数。year 等时效字段应以用户明确提供或有效缓存为准，不要在缺参时猜测。
• 适合法国个人所得税的计算与官方资料检索；其他税种、非法国税务问题不在此技能覆盖范围内。