Time.ir Calendar

time-ir-mcp：AI エージェント向け Time.ir イラン暦 MCP サーバー

time-ir-mcp は、Time.ir（تایم، تقویم و ساعت ایران）のイラン暦を AI エージェントに提供する、非公式の読み取り専用 MCP サーバーです。
13 個のツールで、ジャラリー暦、グレゴリオ暦、ヒジュラ暦による今日の日付の取得、日付の変換、月とその行事の表示、
日または年の行事と公式祝日の一覧表示、次の祝日の検索、イランの都市における今日の礼拝時刻（اوقات شرعی）の取得ができます。
API キーやアカウントは不要です。Claude、Cursor、Copilot、その他すべての MCP クライアントで動作します。

AI エージェント向け · クイックスタート · ツール · 知っておくとよいこと · فارسی

---

AI エージェント向け

• 概要： time.ir 向けの非公式 MCP サーバー（モデルコンテキストプロトコル）です。イランの3種類の暦による日付と時刻、日付変換、公式祝日、月間および日ごとの行事（مناسبت‌ها）、イランの都市の礼拝時刻を扱います。
• インストール： uvx time-ir-mcp または claude mcp add time-ir -- uvx time-ir-mcp。トランスポート：stdio。uv（Python 3.10 以降）が必要です。
• 認証： 不要です。TIME_IR_MCP_PROXY（HTTP プロキシ URL、またはカンマ区切りのリスト）は任意です。システムのプロキシ設定は無視されます。
• アクセス： 読み取り専用です。どこにも書き込みを行わないため、ツールの呼び出し前に確認は必要ありません。
• ツール： 13 個で、すべて ti_ が接頭辞です。一般的な実行順序：ti_today、ti_events（祝日かどうか）、ti_upcoming_holidays、ti_cities → ti_prayer_times。
• 使用する場面： ユーザーがイランの日付、ジャラリー暦（شمسی）・グレゴリオ暦（میلادی）・ヒジュラ暦（قمری）間の日付変換、ある日が公式祝日かどうか、その日の行事、次の祝日、イランの都市のアザーン時刻を尋ねた場合に使用します。
• 使用しない場面： ユーザーが他国の祝日や時刻を知りたい場合（Time.ir が対応するのはイランの公式暦のみです）。
• 出力： 簡潔な JSON です。日付はジャラリー暦、グレゴリオ暦、ヒジュラ暦の YYYY-MM-DD 形式の文字列で、時刻はイラン現地時間（24 時間制）です。タイトルと説明は Time.ir と同じペルシア語です。

ツール

ツール	説明
ti_today	テヘランの時刻、曜日、星座、今日の行事とともに、今日の日付をジャラリー暦、グレゴリオ暦、ヒジュラ暦で取得します
ti_convert_date	time.ir 独自のコンバーターを使って、ジャラリー暦、グレゴリオ暦、ヒジュラ暦の間で日付を変換します
ti_month	ジャラリー暦の1か月を表示します。グレゴリオ暦とヒジュラ暦での期間、1日の曜日、祝日、金曜日、すべての行事を確認できます
ti_events	ある日の行事と公式祝日を一覧表示します。time.ir に説明がある場合は短い説明も表示します
ti_holidays	ジャラリー暦の1年分の公式祝日を、グレゴリオ暦とヒジュラ暦の日付とともに一覧表示します
ti_upcoming_holidays	イランの次の公式祝日を、それぞれの日までの日数とともに一覧表示します
ti_prayer_times	イランの都市における今日の礼拝時刻（ファジュル、日の出、正午、日没、マグリブ、イスラムの深夜、日照時間）を取得します
ti_cities	イランの州、または1つの州の都市を、礼拝時刻ツールで使用する ID とともに一覧表示します
ti_on_this_day	time.ir の今日のページから、今日の歴史上の出来事、著名人の誕生と死去を一覧表示します
ti_search_events	ジャラリー暦の1年分のすべての行事を、キーワード、祝日フラグ、または暦で検索します
ti_date_difference	2つの日付の間の日数を数え、ジャラリー暦での年、月、日を表示します（年齢計算）
ti_long_weekends	ジャラリー暦の1年のうち、連休（祝日と金曜日）が続く期間を探します
ti_qibla	イランの都市からメッカへのキブラの方角と距離を取得します（サイトの座標から算出）

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

クイックスタート

uv が必要です。API キーやアカウントは不要です。

claude mcp add time-ir -- uvx time-ir-mcp

Claude Desktop、Cursor、Windsurf、Gemini CLI では、同じ stdio エントリを使用します。

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

プロンプトの例：「今日のジャラリー暦の日付は？」「12月25日はイランの祝日ですか？」「次の公式祝日はいつですか？」 「1405-01-01をグレゴリオ暦とヒジュラ暦に変換して。」「今日のマシュハドのアザーンの時刻は？」 «تاریخ امروز به شمسی چیست؟»، «اذان ظهر شیراز چه ساعتی است؟»، «تعطیلات رسمی بهمن ۱۴۰۵ کدام‌اند؟»

仕組み

time-ir-mcp はローカルで動作し、time.ir のページが呼び出すものと同じ「サーバーアクション」を呼び出します（www.time.ir は Next.js アプリです。 サイトのサーバーは api.time.ir を独自のキーで読み取りますが、このサーバーがそのキーを見ることはありません）。リクエストは Chrome を偽装するクライアント経由で送信され、少なくとも1秒間隔で実行されて10分間キャッシュされます（現在時刻は キャッシュされません）。接続先は www.time.ir のみです。アクション ID はサイトの再デプロイ時に変わります。サイトが ID を拒否した場合、サーバーは サイトのスクリプトから関数名で新しい ID を検索し、1回だけ再試行します。

知っておくとよいこと

• イランの公式暦のみです。 祝日はイランのものです。ヒジュラ暦の日付もイランのものであり、サウジアラビアとは1日異なる場合があります。世界時計はありません。
• 金曜日は週末であり、それ自体が祝日として報告されることはありません。ただし、行事に伴う祝日と金曜日が重なる場合は報告されます。
• 礼拝時刻は指定されたジャラリー暦の日付（他の暦は事前に変換されます）に基づく、イラン現地時間です。州都以外の都市では province が必要です。
• ペルシャ語のデータです。 タイトルと説明はペルシャ語です。行事の説明はサイト上では HTML 形式ですが、ツールはプレーンテキストを返し、900文字で切り捨てます。
• 仕様変更の影響を受けやすいものです。 サイトには公開 API がありません。ページが変更されると、サーバーが更新されるまでツールが動作しないことがあります。

فارسی

開発

uv sync
uv run ruff check . && uv run ruff format --check .
uv run python -m pytest -q          # offline tests on recorded time.ir answers
uv run python -m pytest -m live -q  # calls the real time.ir site
uv build

免責事項

Time.ir または Radcom とは無関係の非公式プロジェクトであり、両者からの推奨を受けていません。読み取り専用で、www.time.ir の公開ページを使用しています。これらのページは予告なく変更される場合があります。宗教上または法的な目的では、公式情報源をご確認ください。

作者

Sepehr Radmard（سپهر رادمرد）が開発・保守しています。LinkedIn でつながるか、GitHub の @sepehr071 をフォローして、iran-mcp に掲載されているイランのウェブサイト向け MCP サーバーをご覧ください。

ライセンス

MIT