TGJU Prices

tgju-mcp：面向 AI Agent 的 TGJU MCP 服务（伊朗的美元、黄金、硬币和加密货币价格）

让你的 AI Agent 从 TGJU（tgju.org）读取伊朗实时市场价格。
一个非官方、只读的 TGJU MCP 服务（شبکه اطلاع‌رسانی طلا، سکه و ارز），适用于伊朗的市场价格门户：
美元、欧元、黄金、硬币、加密货币和大宗商品价格、分类表格及每日历史数据，可通过 Claude、Cursor 或 Copilot 获取。

面向 AI Agent · 原因 · 功能 · 快速开始 · 工具 · 工作原理 · 须知 · 常见问题 · 配置 · فارسی · 开发

面向 AI Agent

• **简介：**面向 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、以 USD 计价的加密货币、货币对）保留其列出的单位（unit: as_listed）。
• 机器可读：server.json 和 iran-mcp 目录。

原因

伊朗人会在 TGJU 查询美元、黄金和硬币价格，但它是一个内容繁多、包含数百个符号的网页。 要回答“今天美元、18K 金克重和 Emami 硬币的价格是多少？过去一个月美元走势如何？”需要浏览好几个页面。借助 tgju-mcp，Agent 只需调用几次即可回答，并返回简短摘要，而非原始表格。

**你：**今天的主要汇率是多少？美元近期走势如何？

**Agent：**调用 tj_market_summary -> tj_search_symbols -> tj_price_history

它通过一次调用读取主要汇率，找到美元符号，并总结近期每日收盘价。

每条回复都会经过精简，控制在约 15 KB 以内，避免占满 Agent 的上下文。

功能

• 一键汇总市场行情：美元、欧元、迪拉姆、英镑、里拉、黄金克价和盎司价、金币、白银、布伦特原油、Bitcoin、Ethereum、Tether
• 查询代码行情：一个或多个代码的实时价格、涨跌幅、最高价和最低价
• 查看分类价格表：黄金、金币、零售金币、货币、官方货币、Sana、Nima、加密货币，或任意文件夹 ID
• 浏览市场树，查找文件夹和代码
• 搜索代码，按名称在内部、全球和加密货币市场中查找
• 获取每日历史数据：开盘价、最低价、最高价、收盘价和涨跌幅，并支持 Jalali 日期筛选
• 只读设计：无需登录，不提供交易功能

提示词示例：

• “现在美元、欧元和 18K 黄金克价是多少？”
• “显示金币价格表。”
• “过去 30 天自由市场美元的走势如何？”
• “Bitcoin 和 Tether 的 Toman 价格是多少？”
• “查找布伦特原油的代码，并显示其最新价格。”
• قیمت دلار، یورو و طلای ۱۸ عیار الان چند است؟
• جدول قیمت سکه امروز را نشان بده.
• روند قیمت دلار در یک ماه گذشته چطور بوده؟

快速开始

你需要安装 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"] }
  }
}

工具

代码是小写 slug，例如 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-try-ask 等货币对沿用其标注的单位（as_listed）。
• 单位规则是根据符号名称推断的启发式规则，因此请在 tgju.org 上核对不常见的符号。文件夹 ID 表格会逐行应用此规则（unit: mixed）；不符合规则的符号（例如使用 slug 名称的兑换店报价）仍沿用标注的单位（as_listed）。
• 回复上限： tj_category_table 和 tj_price_history 最多返回 50 行，因此回复会控制在约 14 KB 以内。
• 过时报价： 超过 2 天的报价会带有 stale: true。流动性低的符号可能存在延迟，请检查 time。
• 实时数据流中缺少的符号（来自 tj_search_symbols 的 slug）会由 tj_get_prices 使用最新的每日收盘价回复（source: history，time = 日期）。
• 日期： 历史数据会返回公历和波斯历日期；from_date 和 to_date 筛选条件使用波斯历 YYYY/MM/DD 格式。
• 搜索最多返回 10 条结果。
• 不支持的功能： 不支持交易或下单、账户功能，也不提供 TGJU 数据流之外的价格。
• 网络： 测试时，tgju.org 可通过代理和直连响应普通请求。如果你的网络屏蔽了它，请设置 TGJU_MCP_PROXY。系统代理变量会被有意忽略。

常见问题

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 中；每个工具都是带类型注解的异步函数，并附有说明何时使用它的文档字符串。欢迎提交问题和 PR。

发布：更新 pyproject.toml 和 server.json 中的版本，然后推送一个 v* 标签。GitHub Actions 会发布到 PyPI。

相关服务

• iran-mcp：所有伊朗服务 MCP 服务的目录
• tsetmc-mcp，提供德黑兰证券交易所报价和指数
• iran-crypto-mcp，提供伊朗交易所的加密货币价格
• milligold-mcp，提供 Milli 上的黄金价格
• iran-news-mcp，提供伊朗新闻

免责声明

本项目未经 TGJU 官方授权，也与其无关联。该服务为只读服务，使用 tgju.org Web 应用的接口，这些接口可能在未事先通知的情况下发生变化。价格仅供参考，可能存在延迟，不构成财务建议。

作者

由 Sepehr Radmard（سپهر رادمرد）构建并维护。可通过 LinkedIn 联系，或在 GitHub 上关注 @sepehr071，了解更多面向伊朗网站的 MCP 服务，所有服务均列于 iran-mcp。如果它为您节省了时间，请在仓库点个星，帮助其他人找到它。

许可证

MIT