French Tax MCP

🚀 法國稅務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替代網頁抓取。