French Tax MCP

🚀 フランス税MCPサーバー

このMCP（Model Context Protocol）サーバーは、AIアシスタントにフランスの個人所得税計算を提供します。

🚀 クイックスタート

このサーバーを使用することで、AIアシスタントはフランスの個人所得税計算を行うことができます。

✨ 主な機能

• 個人所得税計算：課税所得と世帯構成（quotient familial）に基づいて、フランスの所得税（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: 税務年度（オプション、デフォルトは現在の年度）

例:

2人の子供を持つ50,000€の給与に対する所得税を計算する

get_tax_brackets

現在のフランスの所得税税率表を取得します。

パラメーター:

• year: 税務年度（オプション、デフォルトは現在の年度）

例:

現在のフランスの税率表は何ですか？

💻 使用例

基本的な使用法

45,000€の給与に対していくらの所得税を支払う必要がありますか？

高度な使用法

1人の子供を持つ60,000€を稼ぐ夫婦の税を計算する

2024年のフランスの税率表を表示してください

🔧 技術詳細

データソース

現在のバージョンでは、MarkItDownを使用したウェブスクレイピングにより、公式のフランス政府ウェブサイト（主にservice - public.fr）から税務情報を取得しています。将来的には、利用可能になった場合、公式のAPIまたは他のより信頼性の高いデータソースに置き換えられる可能性があります。

🚫 制限事項

• 現在はフランスの居住者の個人所得税計算のみをサポートしています。
• ウェブスクレイピングは時々失敗する可能性があります（その場合はバックアップデータが使用されます）。
• 税務計算は参考情報としてのみ提供されています。

📋 今後の予定

将来のバージョンでは以下の機能が追加される可能性があります。

• [ ] LMNP（Location Meublée Non Professionnelle） - 家具付き賃貸の税計算
• [ ] Pinel投資 - 不動産投資の税優遇
• [ ] マイクロ企業/自営業 - 事業税計算
• [ ] 法人税 - 会社の税計算
• [ ] 不動産税 - 不動産税情報
• [ ] 社会保険料 - 社会保障負担
• [ ] 税務申告書 - 詳細な申告書ガイダンスと記入支援
• [ ] 公式API統合 - ウェブスクレイピングを公式の政府APIに置き換える

開発について

ローカル開発

# リポジトリをクローン
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/

法的注意事項

このツールは参考情報としてのみ情報を提供しており、専門的な税務アドバイスを構成するものではありません。あなたの個人情報に適したアドバイスについては、公認会計士または税務顧問に相談してください。

税務情報は公式のフランス政府ウェブサイトから取得されていますが、税法の最新の変更を反映していない場合があります。常に公式ソースで計算を確認してください。

📄 ライセンス

このプロジェクトはApache License 2.0の下でライセンスされています。詳細についてはLICENSEファイルを参照してください。

リンク

• フランス税務公式ウェブサイト：https://www.impots.gouv.fr
• MCPプロトコル：https://modelcontextprotocol.io/