Qavanin

qavanin-mcp：イランの法律・規制を扱うAIエージェント向けMCPサーバー

AI エージェントにイランの法律（قوانین و مقررات ایران）を読ませましょう。
qavanin.ir（سامانه ملی قوانین و مقررات جمهوری اسلامی ایران）、イランの法律、規制、裁判所の判決、法的見解を収録する国立データベース向けの、非公式な読み取り専用MCPサーバーです。
約168,000件の文書をタイトルまたは全文で検索し、法律全体や個別の条文を読んだり、条文の改正履歴を確認したり、その条文を引用する規制や裁判所の判決をたどったりできます。Claude、Cursor、Copilotから利用できます。

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

AI エージェント向け

• 概要： qavanin.ir（イランの国立法律・規制データベース）向けの非公式MCPサーバー（Model Context Protocol）です。ペルシャ語で検索できます（アラビア語のي/كとペルシャ語のی/کは同等です）。日付はジャラーリー暦の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。
• 単位： 日付はジャラーリー暦の文字列（1405/07/22）です。文書ID（id、サイト上のIDS）は20桁の文字列なので、文字列として保持してください。テキストではペルシャ語のی/کを使用します。
• 利用する場面： イランの法律、規制、裁判所の判決、法的見解の内容、承認・公布時期、改正または廃止の有無、それを引用している文書を調べる場合。
• 利用しない場面： ユーザーが法的助言や拘束力のある解釈を必要とする場合。サイトは参考用データベースです。必ず、確認した版と状態を明記してください。repealedまたはamendedと表示された条項は、現行の本文ではありません。
• 機械可読情報： server.jsonおよびiran-mcpカタログ（TOOLS.md、servers.json、llms.txt）。

理由

イランの法律は、数千件に及ぶ法律、施行細則、裁判所の判決、法律意見に分散しており、法律の現行文は後の改正によって変わります。「民法第10条には何と書かれているか、改正されたことがあるか、どの規則が引用しているか」に答えるには、サーバー側でページを生成する動作の遅いサイトを何度も検索する必要があります。qavanin-mcp を使えば、エージェントは数回の呼び出しでこれを行い、892 KBの法律全体ではなく、関連する条文だけを返します。

あなた： ماده ۱۰ قانون مدنی چه می‌گوید؟

エージェント： 呼び出し 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 と 2 つの小さな JSON ルックアップ）を読み取ります。間にホスト型サーバーはなく、API キーも不要です。サイトのボットチェック用 Cookie は Python で処理するため、ブラウザーは必要ありません。

知っておくと便利なこと

• サイトの応答は遅いです： 呼び出しごとに 1〜15 秒かかります。民法典は初回の読み取りに約 15 秒かかりますが、5 分間キャッシュされるため、ページを順に表示する際は高速です。
• 日付はジャラーリー暦です（1405/07/22）。ID は文字列のまま（20 桁）で、テキストはペルシャ語の ی/ک に正規化されます。0000/00/00 などのプレースホルダー日付は除外されます。
• ステータスが重要です： repealed または amended と示された条項は現行の本文ではありません。どのバージョンとステータスを参照したかを明記してください。
• 全文検索ではスニペットが表示されません。 in_text を指定すると法律本文内の語句を検索できるため、候補を qv_law(article=...) で開いてください。
• サイトが検索フィルターを無視することがあります。 データベース全体を返す場合は、サーバーがそれを検出して再試行します。
• 日付順の並べ替えでは同じ日付の項目が存在します。 長いリストをページ送りすると、行が重複したり抜けたりする場合があります。深くページ送りするのではなく、フィルターを絞り込んでください。
• 対象外： コメント、サブスクリプション、購入、アカウント機能。これは調査支援ツールであり、法的助言ではありません。

FAQ

設定

فارسی

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 にあります。それぞれ、エージェントがいつ使用すべきかを説明する docstring を備えた、型付きの非同期関数です。Issue と PR を歓迎します。

リリースするには、pyproject.toml と server.json のバージョンを更新し、v* タグを push してください。GitHub Actions がテストを実行し、PyPI と MCP Registry に公開して、GitHub Release を作成します。

関連サーバー

• Iran Tax MCP server：イランの税金と Codal データ向け
• Paziresh24 MCP server：医師と予約向け
• Iran News MCP server：イランのニュース向け
• Iran Apps MCP server：イランのアプリ向け
• iran-mcp：イラン関連サービスのすべての MCP サーバーのカタログ

免責事項

非公式のプロジェクトであり、qavanin.ir またはイラン政府とは提携しておらず、承認も受けていません。予告なく変更される可能性のある qavanin.ir のウェブサイトのページを読み取ります。これは調査を支援するものであり、法律相談ではありません。リクエスト頻度は適切な範囲に保ってください。

作者

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

ライセンス

MIT

役に立った場合は、スターを付けていただくと、ほかの人にも見つけてもらいやすくなります。