Iran Mercantile Exchange

AI エージェント向け

• 概要： ime.co.ir 向けの非公式 MCP サーバー（model context protocol）です。対象はイラン商品取引所で、現物市場取引（工業・鉱物、石油化学製品・石油製品、セメント、副次市場、キシュ輸出ホール）、供給案件（プレミアム商品と輸出品を含む）、価格履歴、生産者別またはブローカー別ランキング、市場合計、米ドルレート、ニュース、週次レポートへのリンク、オプション一覧、預託証券（金地金、金貨、銀など）、サラフ取引、商品ファンドを扱います。
• インストール： uvx ime-mcp または claude mcp add ime -- uvx ime-mcp。トランスポート：stdio。uv が必要です（Python 3.10 以降）。
• 認証： 不要です。IME_MCP_PROXY は任意です（HTTP プロキシ URL、またはカンマ区切りのリスト）。システムのプロキシ設定は無視されます。
• アクセス： 読み取り専用です。取引や注文はできないため、ツールを呼び出す前の確認は不要です。
• ツール： 14 個あり、すべて ime_ で始まります。一般的な実行順序：ime_categories -> ime_price_history / ime_trades / ime_supply；ime_producers -> ime_trades；ime_options -> ime_options(contract=...)；ime_certificates -> ime_certificates(commodity=...)。
• 利用する場面： 取引所で何が取引されたか、鉄鋼、鉄筋、熱延鋼板、ポリマー、ビチューメン、セメントの価格、次の取引日に供給される商品、取引規模、取引所の米ドルレート、オプション契約、金地金・金貨・銀の預託証券の価格についてユーザーから質問された場合に利用します。
• 利用しない場面： 株式市場（TSETMC）、不動産、自動車取引に関する質問には利用しないでください。これらは対象外です。
• 出力： コンパクトな JSON です。日付はペルシャ暦（1405/08/09）です。グレゴリオ暦の日付も入力できます。価格はリアルです（トン単位で集計される商品は kg あたりです。unit を確認してください）。value_k_rial は千リアル、サマリー値は百万リアル、value_rial（オプション、預託証券、ファンド）はリアルです。テキストはペルシャ語です。
• 機械可読情報： server.json と iran-mcp カタログ。

理由

IME サイトでは、取引と供給の情報をフィルターフォームとページ分割されたテーブルでしか確認できません。「今月、熱延鋼板の価格はどう動いた？」を調べるには、グループとサブグループ、日付範囲を選び、テーブルの行を一つずつ読む必要があります。ime-mcp を使えば、エージェントが1回の呼び出しで調べられます。

あなた： アーバーン月の初めから、熱延鋼板の価格はどう動きましたか？

エージェント： 次を呼び出します ime_price_history(search="ورق گرم", date_from="1405/08/01")

カヴィアンの熱延鋼板（KAS-HS00000-00）は、08/02に1,305,425リアル/kg（3,740 t）、08/03に1,296,722（1,430 t）、08/06に1,370,586（2,310 t）、08/09に1,352,960（110 t）で取引されました。

_{2026-10-31のライブ呼び出しによる数値です。}

できること

• 取引：現物市場、二次市場（بازار فرعی）、キシュ輸出ホールにおける指定日付範囲内のすべての取引を確認できます。加重終値、安値、高値、供給量、需要量、出来高、金額、生産者、契約種別、納入条件、ブローカーを表示し、商品グループ、生産者、テキストで絞り込めます
• 供給オファー（اطلاعیه عرضه）：今後の取引日に売りに出される商品と、数量、基準価格、納入場所と日付、決済条件、ブローカーを確認できます
• 価格履歴：最大45日分の銘柄ごとの日次安値、高値、出来高加重平均、出来高を確認できます
• 市場合計：指定期間の市場・ホール別の金額と出来高、および米ドル決済レートを確認できます。特定市場の日次合計も確認できます
• ランキング：取引金額と市場シェアに基づく生産者、商品、ブローカー、ホールのランキングを確認できます
• オプション：決済価格と建玉を含むオプションボード（金、金貨、金ファンド、サフラン先物）と、特定契約の履歴を確認できます
• 証書とファンド：金地金、金貨、銀、銅、鉄鋼の預託証書、サフラン証書、サラフ、金ファンドを日次で確認でき、買い気配・売り気配ボードも利用できます
• グループと生産者：取引所の商品グループツリーと生産者IDを確認できます
• ニュースとレポート：最新のお知らせと週次レポートPDFへのリンクを確認できます

プロンプトの例：

• 「今日、取引所で最も大きかった取引は何ですか？」
• 「過去2週間で鉄筋の価格はどう動きましたか？」
• 「来週、モバラケ製鉄所から取引所に何が出品されますか？」
• 「今週、現物市場ではホール別にどれだけ取引されましたか？」
• 過去1か月で、商品取引所の熱延鋼板の価格はどのように変化しましたか？
• 明日、商品取引所ではどのような商品が出品されますか？

クイックスタート

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

claude mcp add ime -- uvx ime-mcp

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

グループ ID は ime_categories から、プロデューサー ID は ime_producers から取得します。日付は 1405/08/09 または 2026-10-31 形式です。デフォルトは今日（テヘラン時間）です。期間は最大45日です。

14個すべてのツールに readOnlyHint: true の注釈が付いています。

仕組み

  AI agent  (Claude, Cursor, Copilot, ...)
      │
      │  MCP over stdio
      ▼
  ime-mcp  (runs on your machine)
      │
      │  HTTPS
      └──────▶  www.ime.co.ir   imedata.asmx, auction.ashx, export.ashx, news archive

ime-mcp はローカルで動作し、ホスト型サーバーや API キーを介さずに、ime.co.ir のページが使用するものと同じ公開エンドポイントを呼び出します。リクエストは Chrome を偽装するクライアント経由で送信されます。一度に送信するリクエストは最大3件で、少し間隔にばらつきを設けています。応答は2分間キャッシュされ、失敗したリクエストは最大2回再試行されます。また、www.ime.co.ir、dataapi.ime.co.ir（金などの預託証券）、cdn.ime.co.ir（買い気配／売り気配の板情報）とのみ通信します。

知っておくとよいこと

• イランのネットワーク。 ime.co.ir はイランから応答します。テストではトルコの出口から接続するとタイムアウトしました。イランの回線を直接使うか、アクセス可能なプロキシを IME_MCP_PROXY に設定してください。
• サイトでは現物市場と子会社市場の一覧が混同されています。 取引一覧サービスは日付範囲ごとに最初の応答を保持し、その後は市場フラグを無視します。サーバーは日付範囲を広げて新しいデータを要求し、ホールを確認して、最大6回再試行します。そのため、応答が遅くなることがあります。
• 単位。 トン単位で掲載される商品の価格は、1 kg あたりのリアルです。value_k_rial は価格 × 数量を千リアルで表した値、マーケットサマリーは百万リアル単位です。オプション、証券、預託証券、板情報の value_rial はリアル単位です。
• 取引日。 土曜日から水曜日、および一部の木曜日です。それ以外の日は何も返されません。
• 対象外： 不動産、自動車取引、株式関連のサブサイトは、ime.co.ir の別サブサイトです。統計レポートのアーカイブ（market-reports.html）はフォーム送信が必要なため、読み取りません。週間レポートは PDF へのリンクを表示しますが、解析はしません。子会社市場の一覧には価格や取引額はなく、基準価格、供給、需要、数量のみが含まれます。
• ペルシャ語のデータ。 名前、ホール、契約、ニュースはペルシャ語で返されます。

よくある質問

npx @modelcontextprotocol/inspector uvx ime-mcp

設定

فارسی：イラン商品取引所の MCP サーバー

claude mcp add ime -- uvx ime-mcp

開発

git clone https://github.com/sepehr071/ime-mcp && cd ime-mcp
uv sync
uv run ruff check . && uv run ruff format --check .
uv run python -m pytest -q          # offline unit tests on recorded IME answers
uv run python -m pytest -m live -q  # calls the real ime.co.ir (needs an Iranian line)
uv build

現物市場のツールは src/ime_mcp/ime.py に、デリバティブと証券のツールは src/ime_mcp/securities.py にあります。いずれも、エージェントがいつ使用すべきかを説明する docstring を備えた、型付きの非同期関数です。Issue や PR を歓迎します。

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

関連サーバー

• iran-mcp：イランの各種サービス向け MCP サーバーのカタログ
• mcpfarsi.ir：イランの各種サービス向け MCP サーバーのペルシャ語マーケットプレイス

免責事項

非公式であり、イラン商品取引所とは提携関係になく、同取引所からの推奨も受けていません。読み取り専用で、予告なく変更される可能性がある ime.co.ir ウェブサイトの公開エンドポイントを使用します。投資助言ではありません。取引を行う前に、取引所で価格をご確認ください。

作者

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

ライセンス

MIT