Iran Tax

iran-tax-mcp：面向 AI Agent 的伊朗税务 MCP 服务

让你的 AI Agent 根据税务管理部门自己的公开系统回答伊朗税务问题（مالیات）。
这是一个非官方、只读的 MCP 服务，接入 tax.gov.ir、商品／服务 ID 系统 stuffid.tax.gov.ir 和税务法规数据库 regulation.tax.gov.ir：
电子发票商品 ID 和增值税税率、活动代码、房产交易价值、税法、通函和裁决，以及官方常见问题。

面向 AI Agent · 原因 · 功能 · 快速开始 · 工具 · 工作原理 · 须知 · 常见问题 · 配置 · فارسی · 开发

面向 AI Agent

• 简介： 面向伊朗国家税务管理局（سازمان امور مالیاتی کشور）公共服务的非官方 MCP 服务（模型上下文协议）：tax.gov.ir、stuffid.tax.gov.ir 和 regulation.tax.gov.ir。答案为波斯语文本。
• 安装： 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 及其增值税税率、活动代码及其增值税阶段、某个地址的官方房产价值、税法条文、通函（بخشنامه）或裁决的文本，或官方常见问题的答案。
• 不适用场景： 需要查询纳税人个人数据的任务（申报表、发票、欠税、经济代码查询）。这类操作需要登录或通过验证码验证，本服务不提供。
• 输出： 精简 JSON。日期和年份使用波斯历（1405/07/27、1404）。金额以里亚尔整数表示。空值和空字段会省略。回复大小不超过约 15 KB：长文本将拆分为每段 6000 个字符，列表大小设有上限。
• 网络： 对某个短语首次调用 tx_goods_search 需要 15-30 秒（缓存一小时）。
• 机器可读信息： server.json 和 iran-mcp 目录。

原因

伊朗税务相关答案分散在三个不同的政府网站上，每个网站都有各自的表单、回传机制和搜索页面。查询某种产品的增值税税率，需要慢慢搜索 ID；查找《直接税法》第 169 bis 条，则要在一个 1.6 MB 的页面上不断滚动。使用 iran-tax-mcp，Agent 可以执行搜索、选出正确的文件，并只返回你询问的内容。

你： 电子发票系统中，笔记本电脑的增值税处理方式是什么？

Agent： 调用 tx_goods_search(query="لپ تاپ", limit=5)

它会返回排名最高的有效通用商品 ID，以及对应的增值税税率、类型和有效日期。

每条回复都会经过精简，确保长度不超过约 15 KB，避免占满 Agent 的上下文。

功能

• 查找电子发票商品和服务 ID（شناسه کالا و خدمات），可按描述或 13 位 ID 搜索，并显示增值税税率、类型和有效期限
• 查询活动代码（اینتاکد），包括增值税阶段、业务组和官方利润率
• 查询官方房产价值（ارزش معاملاتی）、每平方米租金价值、手册区块和行，以及地图坐标对应的税务局
• 搜索税法、法规、通告、裁定、意见、往来函件和术语表，按最新内容优先显示
• 读取单份文件全文，或单独读取某一条款（例如 ماده 169 مکرر），并附上官方 PDF 链接
• 搜索税务管理局的官方常见问题
• 只读设计：无需登录，不提交申报，也不付款

提示词示例：

• “查找笔记本电脑的电子发票商品 ID 和增值税税率。”
• “餐厅适用哪个活动代码？其 1404 年的利润率是多少？”
• “纬度 35.70、经度 51.40 处的官方房产每平方米价值是多少？”
• “显示《直接税法》第 169 bis 条（مکرر）。”
• “最新关于电子发票增值税的通告。”
• شناسه کالا و خدمات برای لپ‌تاپ چیست و نرخ ارزش افزوده آن چقدر است؟
• متن ماده ۱۶۹ مکرر قانون مالیات‌های مستقیم را بیاور.
• ارزش معاملاتی ملک در این مختصات چقدر است؟

快速开始

你需要安装 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 在本地运行，并读取这三个网站使用的相同公开页面和端点。中间没有托管服务，也不需要 API 密钥。请求通过模拟 Chrome 的客户端发出，并发请求最多为 4 个，间隔带有轻微抖动；遇到超时、网络错误、5xx 和 429 时，最多重试两次。它只会访问获准的税务主机，且只读取数据。

注意事项

• **网络：**通过土耳其代理出口访问这些网站时会超时，而从伊朗网络直接访问则能获得响应。在伊朗境外，请将 IRAN_TAX_MCP_PROXY 设为使用伊朗出口的 HTTP 代理。系统代理变量会被有意忽略。
• **首次搜索商品较慢：**ID 系统会为每次搜索生成一个文件（对于「لپ تاپ」这类宽泛词组，需要 15-30 秒；这类词组包含数万行）。服务会下载并排序结果（有效的通用 ID 优先），并缓存一小时。每次回复最多包含 20 行。
• **活动代码：**两个数值列是利润率（نسبت سود فعالیت, نسبت سود ناویژه به فروش），不是税率。商业／非商业切换（تجاری / غیرتجاری）没有“全部”选项。
• **房产价值：**结果是所选年份中某个位置的官方交易价值。
• **法规文本：**较长的文档会拆分为每部分 6000 个字符；可请求下一部分 part，或请求单条条文。文档会缓存一小时。
• **单位：**年份和日期采用波斯历；货币以整数里亚尔表示。
• **不支持的功能：**不支持查询经济代码（شماره اقتصادی）或无效公司、不提供证书、申报表、发票或付款服务，也不支持登录或验证码识别。

常见问题解答

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）中；每个工具都是带类型标注的异步函数，并附有说明何时使用它的文档字符串。欢迎提交问题和 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