TGJU Prices

tgju-mcp：AI エージェント向け TGJU MCP サーバー（イランのドル、金、コイン、暗号資産の価格）

AI エージェントが TGJU（tgju.org）からイランの最新市場価格を取得できます。
TGJU（شبکه اطلاع‌رسانی طلا، سکه و ارز）向けの非公式な読み取り専用 MCP サーバーです。TGJU はイランの市場価格ポータルです。
Claude、Cursor、Copilot から、ドル、ユーロ、金、コイン、暗号資産、商品価格、カテゴリー別の表、日次履歴を取得できます。

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

AI エージェント向け

• 概要： tgju.org 向けの非公式 MCP サーバー（モデルコンテキストプロトコル）です。ドル、金、コイン、暗号資産、商品価格を扱うイランのポータルです。シンボル検索では、ペルシャ語と英語の名称を使用できます。
• インストール： uvx tgju-mcp または claude mcp add tgju -- uvx tgju-mcp。トランスポート：stdio。uv が必要です（Python 3.10 以降）。
• 認証： 不要です。API キーやアカウントは必要ありません。TGJU_MCP_PROXY（HTTP プロキシ URL、またはカンマ区切りリスト）は任意です。システムのプロキシ設定は無視されます。
• アクセス： 読み取り専用です。ログインや取引はできないため、ツールの呼び出し前に確認を求める必要はありません。
• ツール： 6 個あり、すべて tj_ で始まります。一般的な順序は tj_market_summary -> tj_category_table -> tj_price_history です。 名称しかわからない場合は、まず tj_search_symbols を呼び出し、その symbol をほかのツールに渡してください。
• 使用する場面： ユーザーがイランのドル、ユーロ、金、コイン、Bitcoin、Brent の価格、グループの価格表、またはシンボルの日次履歴を尋ねた場合。
• 使用しない場面： ユーザーが取引や購入を希望している場合、証券取引所（TSETMC）のデータが必要な場合、または TGJU のデータフィード対象外の市場について尋ねている場合。
• 出力： コンパクトな JSON です。イランの価格はサイト上でリアル建てで表示されます。それらのシンボルには *_toman（リアル / 10）も含まれます。世界市場のシンボル（オンス、Brent、米ドル建ての暗号資産、通貨ペア）は、表示されている単位（unit: as_listed）のままです。
• 機械可読データ： server.json および iran-mcp カタログ。

理由

TGJU はイランの人々がドル、金、コインの価格を確認する場所ですが、数百ものシンボルが掲載された情報量の多いウェブページです。 「現在のドル、18K 金の1グラム、エマミー金貨はいくらで、過去1か月でドルはどう動いた？」という質問に答えるには、画面をいくつも見る必要があります。tgju-mcp を使えば、エージェントはいくつかの呼び出しで回答し、生の表ではなく簡潔な要約を返せます。

あなた： 今日の主な相場はいくらで、最近のドルの値動きはどうですか？

エージェント： 呼び出し tj_market_summary -> tj_search_symbols -> tj_price_history

1回の呼び出しで主要な相場を読み取り、ドルのシンボルを見つけ、最近の日次終値を要約します。

すべての応答は約 15 KB 未満に収まるよう短縮されるため、エージェントのコンテキストを圧迫しません。

できること

• 1 回の呼び出しで市場を要約：ドル、ユーロ、ディルハム、ポンド、リラ、金（グラムとオンス）、コイン、銀、ブレント、Bitcoin、Ethereum、Tether
• 銘柄の価格を取得：1 つまたは複数の銘柄のリアルタイム価格、値動き、高値、安値
• グループの価格表を表示：金、コイン、小売コイン、通貨、政府通貨、Sana、Nima、暗号資産、または任意のフォルダー ID
• 市場ツリーを参照してフォルダーや銘柄を検索
• 内部市場、グローバル市場、暗号資産市場から銘柄を名前で検索
• 日次履歴を取得：Jalali 日付フィルターを使った始値、安値、高値、終値、値動き
• 読み取り専用の設計：ログイン不要、取引不可

プロンプトの例：

• 「ドル、ユーロ、18K 金のグラム価格は今いくらですか？」
• 「コインの価格表を表示してください。」
• 「過去 30 日間で自由市場のドルはどのように推移しましたか？」
• 「Bitcoin と Tether のトマン建て価格を教えてください。」
• 「ブレント原油の銘柄を探して、最新価格を表示してください。」
• قیمت دلار، یورو و طلای ۱۸ عیار الان چند است؟
• جدول قیمت سکه امروز را نشان بده.
• روند قیمت دلار در یک ماه گذشته چطور بوده؟

クイックスタート

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

claude mcp add tgju -- uvx tgju-mcp

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

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

codex mcp add tgju -- uvx tgju-mcp

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

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

ツール

銘柄は price_dollar_rl、geram18、sekee のような小文字のスラッグです。銘柄が分からない場合は、まず tj_search_symbols を呼び出してください。

6 つすべてのツールに readOnlyHint: true が注釈されています。

仕組み

  AI agent  (Claude, Cursor, Copilot, ...)
      │
      │  MCP over stdio
      ▼
  tgju-mcp  (runs on your machine)
      │
      │  HTTPS
      └──────▶  api.tgju.org, call4.tgju.org   live feed, tables, history, search

tgju-mcp はローカルで動作し、tgju.org サイトが使用するものと同じエンドポイントを呼び出します。間にホスト型サーバーはなく、 API キーも不要です。リクエストは Chrome を偽装するクライアント経由で送信され、少しランダムな間隔をあけて一度に最大 2 件まで処理されます。回答は 15 秒間保持され、失敗した GET は再試行されます。また、api.tgju.org と call4.tgju.org との通信のみを行います。読み取り専用です。

知っておくとよいこと

• 単位： フィードには単位フィールドがありません。金のグラム、コイン、自由市場の通貨やその他の price_* 通貨、および crypto-*-irr はリアル単位です（*_toman = リアル / 10）。ons、silver、oil_*、crypto-*（USD）、および usd-try-ask のような通貨ペアは、表示されている単位（as_listed）のままです。
• 単位のルールは シンボル名に基づくヒューリスティックです。通常と異なるシンボルは tgju.org で確認してください。フォルダー ID のテーブルでは行ごとに適用されます（unit: mixed）。取引所のスラッグ名付きの気配値など、対象外のシンボルは as_listed のままです。
• 応答の上限： tj_category_table と tj_price_history は最大 50 行を返すため、応答は約 14 KB 未満に収まります。
• 古い気配値： 2 日を超える古い気配値には stale: true が付きます。流動性の低いシンボルは遅れることがあるため、time を確認してください。
• ライブフィードにないシンボル（tj_search_symbols が返すスラッグ）は、tj_get_prices が最新の日次終値を返します（source: history、time = 日付）。
• 日付： 履歴はグレゴリオ暦とジャラーリー暦の日付を返します。from_date と to_date のフィルターには、ジャラーリー暦の YYYY/MM/DD を指定します。
• 検索 で返される結果は最大 10 件です。
• 対応していないこと： 取引や注文、アカウント機能、TGJU フィード以外の価格には対応していません。
• ネットワーク： テスト時、tgju.org はプロキシ経由と直接接続のどちらからも通常のリクエストに応答しました。ネットワークでブロックされる場合は、TGJU_MCP_PROXY を設定してください。システムのプロキシ変数は意図的に無視されます。

FAQ

npx @modelcontextprotocol/inspector uvx tgju-mcp

設定

ペルシャ語：ドル、金、コイン価格のMCPサーバー（TGJU）

claude mcp add tgju -- uvx tgju-mcp

開発

git clone https://github.com/sepehr071/tgju-mcp && cd tgju-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 tgju.org
uv build

すべてのツールは src/tgju_mcp/markets.py にあり、それぞれ型指定された非同期関数です。各関数のドキュメント文字列には、エージェントがその関数を使用する場面が記載されています。IssueやPRを歓迎します。

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

関連サーバー

• iran-mcp：イランのサービス向けMCPサーバーのカタログ
• テヘラン証券取引所の株価と指数を扱う tsetmc-mcp
• イランの取引所における暗号資産価格を扱う iran-crypto-mcp
• Milliの金価格を扱う milligold-mcp
• イランのニュースを扱う iran-news-mcp

免責事項

TGJUとは無関係の非公式プロジェクトであり、TGJUから承認や推奨を受けていません。読み取り専用で、予告なく変更される可能性があるtgju.orgウェブアプリのエンドポイントを使用します。価格は参考情報であり、遅延する場合があります。金融アドバイスではありません。

作者

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

ライセンス

MIT