TaxBrainAI MCP

taxbrainai-mcp

インドの個人所得税業務（ITR-1/2/3/4および申告後の通知）向けに8 個のツールを提供する、スタンドアロンのMCPサーバーです。FastMCPを基盤に、決定論的なtaxbrainai-computeエンジンと、パッケージに同梱された小規模な法令グラフを薄くラップしています。

API キーなしで完全にオフラインで動作します。ここにある各ツールは決定論的に動作するか、任意の持ち込みインデックスを使って検索します。このパッケージ内では、どこでもLLM を呼び出しません。

これは、より大規模なTaxBrainAIプロジェクトから切り出した、自己完結型の MCP 機能です。 完全版製品では、これらのツールのうち 3 つが LLM／ビジョンモデルとホスト型の判例コーパスによって支えられていますが、ここではその部分を決定論的な代替機能に置き換えるか、任意機能にしています。そのため、プライベートなバックエンドやシークレット、第三者データの再配布なしに、パッケージをインストールして起動できます。以下の「各ツールについての説明」を参照してください。

8 個のツール

#	ツール	種類	機能
1	compute_tax	決定論的 — Decimal 計算	構造化入力（給与、キャピタルゲイン、控除、年齢、居住資格、税制）に基づく所得税額を計算します。計算処理に LLM は使いません。
2	regime_compare	決定論的 — Decimal 計算	同じ入力に対して旧税制と新税制を比較し、節税額の差と法定根拠の引用を添えて、税額が低い方を推奨します。
3	simulate_scenario	決定論的 — Decimal 計算	もしも分析：基本入力に変更を適用し、変更前後の税額を比較します。
4	cite_section	決定論的 — 法令グラフ	条文番号から条文名と書式化された引用を取得します。もう一方の法律における対応条文も含みます。
5	compare_acts	決定論的 — 法令グラフ	対応関係グラフを使って、IT Act 1961 ↔ IT Act 2025 の条文を対応付けます。
6	classify_notice	決定論的 — テーブル＋パターンマッチ	テキストのパターンマッチングで通知の条文を特定し、精選した条文・種類・期限・ガイダンスの情報を返します（モデルが生成した情報ではありません）。既知の条文がない場合は、正直に found: false を返します。
7	reconcile_documents	決定論的 — 差分	Form 16／26AS／AIS の事前抽出済みフィールド間にある書類横断の不一致を検出します（出力では PAN をマスキングします）。OCR／ビジョンによる抽出は対象外です。抽出機能はご自身でご用意ください。
8	find_case_law	任意 — BM25 による語彙検索	任意の判例メタデータインデックスを対象に語彙検索します。このパッケージにコーパスは同梱されていません。有効にするには以下の環境変数を設定してください。設定しない場合は、注記付きで空の検索結果を返します。

各ツールについての説明

• 決定論的な Decimal 計算（1～3）： すべての計算は、プロパティベーステスト済みの taxbrainai-compute ライブラリを通じて行われます（Hypothesis による検証済みで、所得税局の公式 ITR ユーティリティと照合済みです）。サーバーが数値を独自に作り出すことはありません。
• 決定論的な法令グラフ（4～5）： パッケージに同梱された 1961↔2025 法令グラフのスナップショット（nodes.csv と edges.csv）を使って回答します。
• 決定論的なテーブル／差分（6～7）： 完全版の TaxBrainAI 製品では、これらのツールは LLM／ビジョンによって支えられています（モデルが通知を読み取り、書類のフィールドを抽出します）。このスタンドアロンサーバーでは決定論的な部分だけを残し、条文／キーワードの照合とフィールド単位の照合差分を行います。そのため、モデルやキーは必要ありません。
• 任意の検索（8）： find_case_law の実行には判例インデックスが必要ですが、同梱されていません（第三者データはここでは再配布しません）。独自のインデックスを指定しない限り、空の検索結果を返して正常に動作します。

インストール

pip install "taxbrainai-mcp[mcp]"     # server + FastMCP SDK
pip install taxbrainai-mcp            # tool library only (no SDK; importable + testable)

taxbrainai-compute は必須の依存関係であり、自動的にインストールされます。

実行

# installed console script
taxbrainai-mcp

# or the module form
python -m taxbrainai_mcp.server

FastMCP の run() はデフォルトで stdio を使い、Streamable HTTP（build_mcp_server().run(transport="streamable-http")）にも対応しています。API キーは必要ありません。

任意：判例検索を有効にする

export TAXBRAIN_MCP_CASELAW_INDEX=/path/to/caselaw.jsonl   # JSONL of {"title","court",...}

インデックスが Indian Kanoon（indiankanoon.org）に由来する場合は、その旨を明記してください。

クライアントを接続する（Claude Desktop）

claude_desktop_config.json の mcpServers ブロックに追加します。

{
  "mcpServers": {
    "taxbrain": {
      "command": "taxbrainai-mcp"
    }
  }
}

コンソールスクリプトが PATH にない場合は、"command": "python", "args": ["-m", "taxbrainai_mcp.server"] を使用してください。

ツールを直接使用する（MCP SDK なし）

ツールのロジックは通常のクラスなので、テストや組み込みに便利です。

from taxbrainai_mcp import TaxBrainTools

t = TaxBrainTools()
print(t.compute_tax({"salary_income": 1275000, "regime": "new"})["total_tax"])  # 0 (rebated under Section 87A)
print(t.compare_acts("147")["equivalence"])

レジストリマニフェスト

server.json は MCP レジストリのマニフェスト（スキーマ 2025-12-11）で、提出用ドラフトとして作成されています。_meta ブロックには、公開前の正確なチェックリスト（PyPI 名の取得／公開、スキーマに対する検証、io.github.harshil-projects 名前空間の認証）が記載されています。このパッケージは stdio 経由でローカル実行されます。ホストされたリモートエンドポイントはありません。

対象範囲と免責事項

居住者である個人／HUF 向けの AY 2026-27／FY 2025-26（ITR-1/2/3/4）を対象としています。これは推定用ソフトウェアであり、税務、法律、金融に関する助言ではありません。数値を信頼する前に、公式の電子申告ユーティリティと有資格の専門家に確認してください。

ライセンス

MIT — LICENSE を参照してください。同梱の法令グラフデータは、所得税法の本文（公式の法令本文）に由来します。taxbrainai-compute は MIT ライセンスです。

---

mcp-name: io.github.harshil-projects/taxbrainai-mcp