Iran Crypto Exchanges

AI エージェント向け

• 概要： イランの7つの暗号資産取引所（Nobitex、Wallex、Bitpin、Ramzinex、Tabdeal、OMPFinex、Exir）の公開市場データを取得する非公式 MCP サーバーです。
• インストール： uvx iran-crypto-mcp または claude mcp add iran-crypto -- uvx iran-crypto-mcp。トランスポートは stdio です。uv（Python 3.10 以降）が必要です。
• 認証： 不要です。API キーやアカウントは必要ありません。任意で IRAN_CRYPTO_MCP_PROXY（HTTP プロキシ URL、またはカンマ区切りのリスト）を指定できます。システムのプロキシ設定は無視されます。
• アクセス： 読み取り専用です。ログイン、残高、注文、取引には対応していないため、ツールの呼び出し前に確認を求める必要はありません。
• ツール： すべて ic_ で始まる8つのツールがあります。まず ic_compare_price を使用してください。一般的な手順は ic_compare_price -> ic_get_orderbook -> ic_candles です。
• 使用する場面： イランの取引所間でコインの価格を比較する場合、スプレッドを確認する場合、オーダーブックや直近の取引を調べる場合、または24時間の値上がり・値下がり銘柄を一覧表示する場合に使用します。
• 使用しない場面： ユーザーが購入、売却、送金を希望する場合、アカウント情報が必要な場合、またはイラン以外の取引所を希望する場合は使用しないでください。
• 出力： コンパクトな JSON です。すべての IRT 価格はトマン建てです（フィールド名は *_toman）。USDT 市場のフィールド名は *_usdt です。
• 機械可読データ： server.json および awesome-iran-mcp カタログ。

概要

• リヤルとトマン。 Nobitex、Ramzinex、OMPFinex はリヤル建てで価格を公開し、Wallex、Bitpin、Tabdeal、Exir はトマン建てで公開しています。そのため、同じ BTC でも価格が10倍異なります。このサーバーはすべての価格をトマンに換算するので、数値を直接比較できます。
• 7つのサイトを手作業で確認。 各取引所にはそれぞれ独自のアプリ、シンボル、API 形式があります。ic_compare_price を1回呼び出すと、各取引所のコイン価格が最安値順にスプレッドとともに返されます。
• ペルシャ語名。 各取引所の行には name_fa が含まれています。これは取引所独自のペルシャ語名なので、ペルシャ語で回答する際にモデルが名前の表記を推測する必要はありません。

できること

• 7つすべての取引所で、1つのコインの価格をトマンまたはUSDTで比較し、スプレッドとともに安い順に表示します
• ティッカーを取得します。取引所が公開している場合は、最終価格、24時間の値幅と変動率、出来高、最良買値／最良売値を表示します
• 板情報（片側あたり最大20レベル）と、直近の公開取引を読み取ります
• NobitexとWallexからOHLCローソク足（15m、1h、4h、1d）を取得します
• 流動性の低いコインを除外し、取引所の24時間値上がり率・値下がり率上位を順位付けします
• 取引所でトマンまたはUSDT建てで取引されているコインを一覧表示します

プロンプトの例：

• 「イランのすべての取引所でBTC価格をトマン建てで比較してください。最も安いのはどこですか？」
• 「各取引所の現在のテザー（USDT）レートをトマン建てで教えてください。」
• 「NobitexのETHの板情報を表示してください。スプレッドは実際のものですか？」
• 「過去24時間のWallexの値上がり率上位5銘柄。」
• 「過去2日間のWallexの1時間足BTCローソク足を表示してください。」
• 価格をすべてのイランの取引所でトマン建てで比較してください。
• 今、テザーの価格が最も安い取引所はどこですか？
• Nobitexのイーサリアムの板情報を表示してください。

対応取引所

• 7つすべてが、値動き上位銘柄と2種類の建値（トマン（IRT）とUSDT）に対応しています。USDT市場の価格はUSDTのまま表示されます。
• 「完全」とは、最終価格、買値、売値、24時間の高値と安値、変動率、出来高を意味します。
• Bitpinの出来高は、最善努力による2回目の呼び出しで取得します。失敗した場合、ティッカーに出来高は含まれません。
• Exirが公開しているのはベース通貨の出来高のみのため、最終価格に出来高を掛けてクオート通貨の出来高を概算します。
• ティッカーに最良買値と最良売値がない場合は、ic_get_orderbookを使ってください。
• NobitexはUSDT/IRTのローソク足を拒否します（CDNがHTTP 403を返します。ブラウザーも同様です）。その場合はWallexを使用してください。

クイックスタート

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

claude mcp add iran-crypto -- uvx iran-crypto-mcp

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

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

codex mcp add iran-crypto -- uvx iran-crypto-mcp

[mcp_servers.iran-crypto]
command = "uvx"
args = ["iran-crypto-mcp"]

gemini mcp add iran-crypto uvx iran-crypto-mcp

8 つのツールはすべて読み取り専用です。取引所 ID：nobitex、wallex、bitpin、ramzinex、tabdeal、ompfinex、exir。quote は IRT（トマン、デフォルト）または USDT です。

仕組み

  AI agent  (Claude, Cursor, Copilot, ...)
      │
      │  MCP over stdio
      ▼
  iran-crypto-mcp  (runs on your machine)
      │
      │  HTTPS
      └──────▶  public market-data endpoints of the 7 exchanges

• ローカルで動作し、各取引所の公式サイトが使用する公開エンドポイントを呼び出します。間にホスト型サーバーはなく、API キーも不要です。
• Chrome のような HTTP クライアントを使用し、各取引所の公式サイトと同様に、それぞれの Origin と Referer を送信します。
• 応答は 15 秒間キャッシュされ、同時に実行されるリクエストは最大 2 件です。失敗した GET リクエストは再試行されます。
• 読み取り専用です。アカウント、注文、取引のエンドポイントは呼び出しません。

知っておくとよいこと

• 単位は統一されています。 IRT 価格はトマン（リアル建ての取引所では 10 で割った値）、USDT 価格はそのままです。単位はフィールド名で確認できます：price_toman、price_usdt。
• すべての取引所の行にある name_fa は、その取引所独自のペルシャ語名です。
• 特定の取引所だけが失敗することがあります。 ic_compare_price は、失敗した取引所を errors に報告し、残りの取引所の比較は続行します。HTTP 403 は、その取引所の CDN がネットワークからのアクセスを拒否していることを意味します。IRAN_CRYPTO_MCP_PROXY にイランの HTTP プロキシを設定して、もう一度お試しください。
• 価格差が常に実在するとは限りません。 手数料、流動性、古い最終取引価格など、実際の理由で相場が異なることがあります。取引を行う前に、両方の取引所の注文板を確認してください。
• 応答サイズには上限があります。 約 15 KB 以内に収めるため、注文板は 20 レベル、取引は 50 件、ローソク足は 100 件、値上がり・値下がり銘柄は 25 件に制限されます。
• 値上がり・値下がり上位の銘柄 では、24 時間の出来高が下限（デフォルトで 100,000,000 トマンまたは 10,000 USDT）を下回るコインは除外されます。min_volume を設定すると変更できます。Tabdeal は出来高を公開していないため、同取引所のコインは除外されません。
• 価格は参考情報です。 価格はほぼリアルタイム（15 秒間キャッシュ）ですが、その価格で取引できることを保証するものではありません。

よくある質問

設定

ペルシャ語

claude mcp add iran-crypto -- uvx iran-crypto-mcp

開発

git clone https://github.com/sepehr071/iran-crypto-mcp && cd iran-crypto-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 exchange APIs
uv build

ツールは src/iran_crypto_mcp/markets.py にあり、取引所ごとのアダプターは exchanges.py にあります。Issue や PR を歓迎します。 リリースするには、pyproject.toml と server.json のバージョンを更新してから、v* タグをプッシュしてください。

関連サーバー

• awesome-iran-mcp：イランのサービスに対応するすべての MCP サーバーのカタログ
• tgju-mcp：TGJU のドル、金、コイン、商品価格
• tsetmc-mcp：テヘラン証券取引所
• milligold-mcp：金価格
• iran-news-mcp：イランのニュース

免責事項

非公式のプロジェクトであり、いずれの取引所とも提携しておらず、承認も受けていません。公開市場データのみを読み取ります。キーやアカウントへのアクセスは不要で、取引も行いません。価格は情報提供のみを目的としており、金融アドバイスではありません。また、エンドポイントは予告なく変更される場合があります。

作者

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

ライセンス

MIT