Qavanin

qavanin-mcp：面向 AI Agent 的伊朗法律法规 MCP 服务

让你的 AI Agent 阅读伊朗法律（قوانین و مقررات ایران）。
一个面向 qavanin.ir（سامانه ملی قوانین و مقررات جمهوری اسلامی ایران）的非官方、只读 MCP 服务；该网站是伊朗法律、法规、法院表决和法律意见的国家数据库。
按标题或全文搜索约 168,000 份文档，阅读法律或单条条文，查看条文的修订情况，并追踪引用该条文的法规和法院表决；所有操作均可通过 Claude、Cursor 或 Copilot 完成。

面向 AI Agent · 原因 · 功能 · 快速开始 · 工具 · 工作原理 · 须知 · 常见问题 · 配置 · فارسی · 开发 · 相关服务 · 免责声明 · 许可证

面向 AI Agent

• **简介：**面向 qavanin.ir（伊朗国家法律法规数据库）的非官方 MCP 服务（模型上下文协议）。支持使用波斯语查询（阿拉伯语 ي/ك 与波斯语 ی/ک 等同）；日期采用 Jalali YYYY/MM/DD 格式。
• 安装：uvx qavanin-mcp 或 claude mcp add qavanin -- uvx qavanin-mcp。传输方式：stdio。需要安装 uv（Python 3.10+）。
• **身份验证：**无需身份验证、API 密钥或账户。可选设置 QAVANIN_MCP_PROXY（HTTP 代理 URL，或按顺序尝试的逗号分隔列表）；系统代理设置会被忽略。
• **访问权限：**只读。不存在登录、订阅或购买调用，因此调用任何工具前均无需确认。
• **工具：**共 7 个，名称均以 qv_ 为前缀。典型调用顺序：qv_search -> qv_law（带 article）-> qv_amendments -> qv_article_history。
• **单位：**日期采用 Jalali 字符串（1405/07/22）；文档 ID（id，网站上的 IDS）为 20 位字符串，请将其保留为字符串；文本使用波斯语 ی/ک。
• **适用场景：**查询伊朗法律、法规、法院裁决或法律意见的内容、批准和发布日期、是否修订或废止，以及哪些内容引用了它。
• **不适用场景：**用户需要法律建议或具有约束力的解释时。该网站是参考数据库；请始终说明所查看的版本和状态。标记为 repealed 或 amended 的部分并非现行文本。
• 机器可读信息：server.json 和 iran-mcp catalog（TOOLS.md、servers.json、llms.txt）。

为什么

伊朗的立法散见于数千部法律、附属法规、法院裁决和法律意见中，而一部法律的现行文本取决于后续修订。要回答“《民法典》第 10 条说了什么、是否曾经修订过、哪些法规引用了它？”需要在一个速度缓慢、由服务器渲染的网站上进行大量搜索。使用 qavanin-mcp，Agent 只需几次调用就能完成，并且只返回相关条文，而不是一部 892 KB 的法律。

你： ماده ۱۰ قانون مدنی چه می‌گوید؟

Agent： 调用 qv_search(query="قانون مدنی", kind="law") -> qv_law(ids=..., article="10")

它会找到《民法典》，只读取第 10 条及其注释，还可以进一步调用 qv_article_history，查看该条是否有过修订。

功能

• 搜索约 168,000 部法律、法规、法院裁决和法律意见，可按标题或全文搜索，并按类型、批准机构、执行机构、主题、文档类型、状态、日期和公报编号筛选
• 阅读整部法律的各章节、带注释的单条条文，或截至过去某一日期的文本
• 核查状态：批准、通知和公报的编号及日期、最新状态、执行机构
• 追溯修订：哪些法律修订了这部法律、这部法律修订了哪些法律，以及单条条文的每次修订及其替换文本
• 追踪引用：与某部法律相关的法规、法院裁决和法律意见
• 查询筛选器 ID：批准机构、执行机构、主题、文档类型、状态和整理后的列表
• 专为只读设计：无需登录，没有评论、订阅或购买功能

快速开始

你需要安装 uv。无需 API 密钥或账号。

claude mcp add qavanin -- uvx qavanin-mcp

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

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

codex mcp add qavanin -- uvx qavanin-mcp

[mcp_servers.qavanin]
command = "uvx"
args = ["qavanin-mcp"]

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

然后直接提问：

• “伊朗《民法典》第 10 条说了什么？”
• “这部法律的第 1 条是否曾经修订？请展示修订历史。”
• “查找最近由议会批准的法律，并列出其公报编号。”
• “哪些法规和法院裁决与伊朗《商法典》相关？”
• “显示这部法律截至 1400/01/01 的文本。”
• ماده ۱۰ قانون مدنی چه می‌گوید؟
• آیا ماده ۱ این قانون اصلاح شده است؟ تاریخچه اصلاحات را نشان بده.
• آیین‌نامه‌ها و آرای مرتبط با قانون تجارت کدام‌اند؟

工具

所有工具均返回精简的 JSON。qv_search 返回的文档 ID 可传给其他工具；qv_lookup 可查找 qv_search 筛选器所需的 ID。

这 7 个工具均标注为 readOnlyHint: true。

工作原理

  AI agent  (Claude, Cursor, Copilot, ...)
      │
      │  MCP over stdio
      ▼
  qavanin-mcp  (runs on your machine)
      │
      │  HTTPS
      └──────▶  qavanin.ir   laws, regulations, court votes, opinions

qavanin-mcp 在本地运行，并读取 qavanin.ir 网站提供的相同页面（服务器渲染的 HTML 加上两个小型 JSON 查询）。中间没有托管服务，也不需要 API 密钥。网站的机器人检测 Cookie 由 Python 解决，因此无需浏览器。

须知

• 网站速度较慢： 每次调用需 1-15 秒。民法典首次读取约需 15 秒；缓存时长为 5 分钟，因此翻阅起来很快。
• 日期采用伊朗历（1405/07/22），ID 保持为字符串（20 位），文本统一为波斯语 ی/ک。0000/00/00 等占位日期会被剔除。
• 状态很重要： 标记为 repealed 或 amended 的章节并非现行文本。请说明所读版本及其状态。
• 全文搜索不显示摘要。 使用 in_text 可查找法律文本中的词语，因此请用 qv_law(article=...) 打开候选结果。
• 网站有时会忽略搜索筛选条件并返回整个数据库；服务会检测到这种情况并重试。
• **按日期排序时可能出现并列，**因此翻阅较长列表时可能重复或漏掉行：请缩小筛选范围，而不要深入翻页。
• 不涵盖： 评论、订阅、购买和任何账户功能。这是研究辅助工具，不构成法律建议。

常见问题

配置

波斯语

qavanin-mcp 是一个非官方、只读的伊朗伊斯兰共和国国家法律法规系统 (qavanin.ir) MCP 服务。您的 AI 助手（Claude、Cursor、Copilot 等）可以使用它搜索约 16.8 万份文件，包括法律、法规、司法裁决和法律意见。

功能

• 搜索文件标题或正文，并可按文件类型、批准机构、执行部门、主题、状态、日期和官方公报编号筛选。
• 阅读法律正文、单条条文及其附则，或查看法律在过去某个日期的文本。
• 文件信息：批准和颁布日期、官方公报编号、最新状态和执行部门。
• 修订：哪些法律修订了该法律，以及每条条文的修订历史。
• 相关法规和裁决：与每部法律相关的实施细则、法院裁决和意见。

注意事项

• 只读：无需登录账号，也无需订阅或购买。
• 日期使用伊朗历（例如 1405/07/22），搜索时阿拉伯字母「ي」和「ك」会分别与「ی」和「ک」视为相同。
• 网站响应较慢（每次请求需 1 到 15 秒）。此工具不提供法律建议；请核实每份文本的状态和修订情况。
• 在您自己的系统上运行，无需 API 密钥。

关键词： 伊朗法律法规、国家法律法规系统、伊朗法律、法律正文、《民法典》、司法裁决、咨询意见、法律修订、法律 MCP 服务。

安装（请先安装 uv）。在 Claude Code 中：

claude mcp add qavanin -- uvx qavanin-mcp

开发

git clone https://github.com/sepehr071/qavanin-mcp && cd qavanin-mcp
uv sync
uv run python -m pytest            # offline, against recorded responses
uv run python -m pytest -m live    # real site, slow
uv run ruff check .

工具位于 src/qavanin_mcp/search.py 和 law.py 中；每个工具都是带类型标注的异步函数，并附有说明何时使用它的文档字符串。欢迎提交问题和 PR。

发布：更新 pyproject.toml 和 server.json 中的版本，然后推送一个 v* 标签。GitHub Actions 会运行测试、发布到 PyPI 和 MCP Registry，并创建 GitHub Release。

相关服务

• 伊朗税务 MCP 服务，提供伊朗税务和 Codal 数据
• Paziresh24 MCP 服务，提供医生和预约信息
• 伊朗新闻 MCP 服务，提供伊朗新闻
• 伊朗应用 MCP 服务，提供伊朗应用
• iran-mcp：伊朗服务 MCP 服务目录

免责声明

本项目为非官方项目，与 qavanin.ir 或伊朗政府无关联，也未获其认可。它读取 qavanin.ir 网站的页面，而网站内容可能随时变更；本项目仅供研究参考，不构成法律建议。请合理控制请求频率。

作者

由 Sepehr Radmard（سپهر رادمرد）开发并维护。欢迎通过 LinkedIn 联系，或在 GitHub 上关注 @sepehr071，获取更多面向伊朗网站的 MCP 服务；这些服务均列于 iran-mcp。如果它为您节省了时间，请给仓库点个星，帮助其他人发现它。

许可证

MIT

如果它为您节省了时间，请点个星，帮助其他人发现它。