Iran Tax

iran-tax-mcp：AI エージェント向けイラン税務 MCP サーバー

税務当局の公式公開システムを利用して、AI エージェントがイランの税務に関する質問（مالیات）に回答できるようにします。
税務当局のサイト、商品・サービス ID システム stuffid.tax.gov.ir、税務規則データベース regulation.tax.gov.ir を利用する、非公式の読み取り専用 MCP サーバーです。
電子インボイスの商品 ID と VAT 税率、業種コード、不動産取引価格、税法、通達、裁定、公式 FAQ を扱います。

AI エージェント向け · 理由 · できること · クイックスタート · ツール · 仕組み · 知っておくとよいこと · FAQ · 設定 · فارسی · 開発

AI エージェント向け

• 概要： イラン国税庁（سازمان امور مالیاتی کشور）の公開サービスである tax.gov.ir、stuffid.tax.gov.ir、regulation.tax.gov.ir 向けの非公式 MCP サーバー（モデルコンテキストプロトコル）です。回答はペルシャ語です。
• インストール： uvx iran-tax-mcp または claude mcp add iran-tax -- uvx iran-tax-mcp。トランスポート：stdio。uv（Python 3.10 以降）が必要です。
• 認証： 不要です。API キーやアカウントも必要ありません。IRAN_TAX_MCP_PROXY（HTTP プロキシ URL、またはカンマ区切りのリスト）は任意で指定できます。システムのプロキシ設定は無視されます。各サイトは国外の IP アドレスからのアクセスを拒否することがよくあります。イラン国外から利用する場合は、イラン国内から接続するプロキシを使用してください。
• アクセス： 読み取り専用です。ログイン、申告、インボイス発行、支払いは行わないため、ツールを呼び出す前の確認は不要です。
• ツール： 6 種類あり、すべて tx_ で始まります：tx_goods_search、tx_activity_codes、tx_property_value、tx_regulations_search、tx_regulation_text、tx_faq_search。法律に関する質問では、まず tx_regulations_search を呼び出し、検索結果の id と type を tx_regulation_text に渡してください。
• 利用する場面： 企業や会計士が、電子インボイス用の商品・サービス ID とその VAT 税率、業種コードとその VAT 段階、住所における公式不動産評価額、税法条文の本文、通達（بخشنامه）や裁定、または公式 FAQ の回答を必要とする場合に利用してください。
• 利用しない場面： 納税者本人のデータ（申告書、インボイス、債務、経済コードの照会）が必要なタスクには利用しないでください。これらにはログインまたは CAPTCHA が必要で、提供対象外です。
• 出力： コンパクトな JSON です。日付と年はヒジュラ太陽暦表記です（1405/07/27、1404）。金額はリアル建ての整数です。null と空のフィールドは省略されます。応答は約 15 KB 以内です。長文は 6000 文字ずつに分割され、リストの件数には上限があります。
• ネットワーク： tx_goods_search で語句を検索する初回は 15～30 秒かかります（1 時間キャッシュされます）。
• 機械可読データ： server.json と iran-mcp カタログ。

理由

イランの税務情報は、それぞれ独自のフォーム、ポストバック、検索画面を備えた3つの政府サイトに分散しています。ある製品のVAT税率を調べるには時間のかかるID検索が必要で、直接税法の第169条の2を探すには1.6 MBのページをスクロールしなければなりません。iran-tax-mcpを使えば、エージェントが検索を実行し、適切な文書を選び、求められた箇所だけを返します。

あなた： 電子請求書システムでのノートパソコンのVATの扱いはどうなっていますか？

エージェント： 呼び出し tx_goods_search(query="لپ تاپ", limit=5)

有効な一般商品IDのうち、順位が最も高いものと、そのVAT税率、種類、有効期間が返されます。

すべての応答は、エージェントのコンテキストをあふれさせないよう、約15 KB以内に収まるよう調整されています。

できること

• 電子請求書の商品・サービスID（شناسه کالا و خدمات）を、説明または13桁のIDから検索できます。VAT税率、種類、有効期間も確認できます
• 事業活動コード（اینتاکد）を検索できます。VAT段階、事業グループ、公定利益率も確認できます
• 公定不動産評価額（ارزش معاملاتی）と1 m²あたりの賃料を確認できます。地図上の地点から冊子の区画・行と税務署も調べられます
• 税法、規則、通達、裁定、意見書、書簡、用語集を新しい順に検索できます
• 1件の文書の全文、またはماده 169 مکررのような特定の条文を、公定PDFリンクとともに取得できます
• 税務当局の公式FAQを検索できます
• 読み取り専用設計：ログイン、申告、支払いはありません

プロンプトの例：

• 「ノートパソコンの電子請求書用商品IDとVAT税率を調べてください。」
• 「レストランに適した事業活動コードはどれですか？また、1404年の利益率を教えてください。」
• 「緯度35.70、経度51.40地点の1 m²あたりの公定不動産評価額はいくらですか？」
• 「直接税法の第169条の2（مکرر）を表示してください。」
• 「電子請求書におけるVATに関する最新の通達を教えてください。」
• شناسه کالا و خدمات برای لپ‌تاپ چیست و نرخ ارزش افزوده آن چقدر است؟
• متن ماده ۱۶۹ مکرر قانون مالیات‌های مستقیم را بیاور.
• ارزش معاملاتی ملک در این مختصات چقدر است؟

クイックスタート

uvが必要です。APIキーやアカウントは不要です。イラン国外から利用する場合は、知っておくとよいことのプロキシに関する注意事項をご覧ください。

claude mcp add iran-tax -- uvx iran-tax-mcp

{
  "mcpServers": {
    "iran-tax": { "command": "uvx", "args": ["iran-tax-mcp"] }
  }
}

{
  "servers": {
    "iran-tax": { "type": "stdio", "command": "uvx", "args": ["iran-tax-mcp"] }
  }
}

codex mcp add iran-tax -- uvx iran-tax-mcp

[mcp_servers.iran-tax]
command = "uvx"
args = ["iran-tax-mcp"]

{
  "mcpServers": {
    "iran-tax": { "command": "uvx", "args": ["iran-tax-mcp"] }
  }
}

6つすべてのツールに readOnlyHint: true が注釈として付与されています。

仕組み

  AI agent  (Claude, Cursor, Copilot, ...)
      │
      │  MCP over stdio
      ▼
  iran-tax-mcp  (runs on your machine)
      │
      │  HTTPS
      ├──────▶  tax.gov.ir              activity codes, property values, FAQ
      ├──────▶  stuffid.tax.gov.ir      goods/service IDs and VAT
      └──────▶  regulation.tax.gov.ir   laws, circulars, rulings

iran-tax-mcp はローカルで動作し、3つのサイトが使用しているものと同じ公開ページとエンドポイントを読み取ります。間にホスト型サーバーはなく、APIキーも不要です。リクエストはChromeを偽装するクライアント経由で送信され、一度に最大4件まで、少し間隔を空けて実行されます。タイムアウト、ネットワークエラー、5xx、429の場合は最大2回再試行します。許可された税務関連ホストとの通信のみを行い、読み取り専用です。

知っておくと便利なこと

• ネットワーク： トルコのプロキシ出口経由ではこれらのサイトがタイムアウトしましたが、イランの接続からは直接応答がありました。イラン国外では、IRAN_TAX_MCP_PROXY にイランを出口とするHTTPプロキシを設定してください。システムのプロキシ環境変数は意図的に無視されます。
• 商品検索の初回は時間がかかります： IDシステムは検索のたびにファイルを作成します（数万行を含む「لپ تاپ」のような幅広い語句では15～30秒）。サーバーはファイルをダウンロードしてランキング付けし（有効な一般IDを先に表示）、1時間キャッシュします。応答は最大20行に制限されます。
• 活動コード： 2つの数値列は利益率（نسبت سود فعالیت, نسبت سود ناویژه به فروش）であり、税率ではありません。商業／非商業の切り替え（تجاری / غیرتجاری）に「すべて」の選択肢はありません。
• 不動産価格： 結果は、指定した年における地点の公式取引価格です。
• 規制文書のテキスト： 長い文書は6000文字ごとに分割されます。次の part または単一の記事を指定して取得してください。文書は1時間キャッシュされます。
• 単位： 年と日付はジャラーリー暦、金額は整数のリヤルです。
• 対応していないこと： 経済コード（شماره اقتصادی）や無効な会社の検索、証明書、申告書、請求書、支払い、ログイン、CAPTCHAの解決には対応していません。

FAQ

npx @modelcontextprotocol/inspector uvx iran-tax-mcp

設定

ペルシア語：イラン税務 MCP サーバー

claude mcp add iran-tax -- uvx iran-tax-mcp

開発

git clone https://github.com/sepehr071/iran-tax-mcp && cd iran-tax-mcp
uv sync
uv run ruff check . && uv run ruff format --check .
uv run python -m pytest -q          # offline unit tests
uv run python -m pytest -m live -q  # calls the real tax sites, needs an Iranian connection
uv build

ツールは src/iran_tax_mcp/（goods.py、taxgov.py、regulation.py）にあります。それぞれ、エージェントが使用すべきタイミングを説明する docstring を備えた、型付きの非同期関数です。Issue や PR は歓迎します。

リリースするには、pyproject.toml と server.json のバージョンを更新し、v* タグをプッシュしてください。GitHub Actions が PyPI に公開します。

関連サーバー

• iran-mcp：イランの各種サービス向け MCP サーバーのカタログ
• イランの法律や規則については qavanin-mcp
• イランのニュースについては iran-news-mcp
• ドル、金、硬貨の価格については tgju-mcp
• テヘラン証券取引所については tsetmc-mcp

免責事項

非公式であり、イラン国家税務庁（سازمان امور مالیاتی کشور）との提携関係や、同庁による承認はありません。読み取り専用で、tax.gov.ir、stuffid.tax.gov.ir、regulation.tax.gov.ir の公開ページを使用します。これらのページは予告なく変更される場合があります。情報は参考目的のみであり、税務・法律上のアドバイスではありません。

作者

Sepehr Radmard（سپهر رادمرد）が開発・保守しています。LinkedIn でつながるか、GitHub の @sepehr071 をフォローして、イランのウェブサイト向けの MCP サーバーをご覧ください。すべて iran-mcp に掲載されています。このリポジトリが役に立った場合は、スターを付けていただくと、ほかの人にも見つけてもらいやすくなります。

ライセンス

MIT