French Tax MCP Server

法国税务MCP服务器

 

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

当前功能

此MCP服务器当前支持：

• 个人所得税计算：根据净应税收入和家庭构成（家庭商数）计算法国所得税（impôt sur le revenu）
• 税收级别：从官方政府来源检索当前的法国所得税等级
• 动态数据：使用service-public.fr的网络抓取来获取最新的税务信息，并回退到硬编码数据

数据源

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

安装

# Install via pip
pip install french-tax-mcp

# Or install via uv (recommended)
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：纳税年度（可选，默认为本年度）

例子：

Calculate income tax for 50,000€ salary with 2 children

get_tax_brackets

检索当前的法国所得税等级。

参数：

• year：纳税年度（可选，默认为本年度）

例子：

What are the current French tax brackets?

使用示例

基本计算：

How much income tax will I pay on 45,000€ salary?

家庭情况：

Calculate tax for married couple earning 60,000€ with one child

税级：

Show me the 2024 French tax brackets

局限性

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

TODO-未来功能

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

• \[ \] LMNP（非专业家具租赁） -提供租金税计算
• \[ \] 皮内尔投资 -房地产投资税收优惠
• \[ \] 微型企业/汽车企业家 -营业税计算
• \[ \] 公司税 -公司税计算
• \[ \] 地税 -房地产税信息
• \[ \] 社会负担费用 -社会保障缴款
• \[ \] 纳税申报表 -详细的表格指导和填写协助
• \[ \] API官方集成 -用官方政府API取代网络抓取

发展

地方发展

# Clone the repository
git clone https://github.com/your-username/french-tax-mcp.git
cd french-tax-mcp

# Install in development mode
pip install -e ".[dev]"

# Run the server locally
python -m french_tax_mcp.server --port 8888

运行测试

# Run tests
python -m pytest tests/

法律声明

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

税务信息来源于法国政府官方网站，但可能无法反映税法的最新变化。始终与官方来源核实计算结果。

许可证

此项目根据Apache许可证2.0获得许可-请参阅 许可证 文件以获取详细信息。

链接

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