Milli.gold Prices

milligold-mcp：面向 AI Agent 的 Milli.gold 金价 MCP 服务

让你的 AI Agent 获取 Milli.gold（میلی）的实时 18k 黄金价格。
这是一个面向 Milli.gold 的非官方只读 MCP 服务。Milli.gold 是一个伊朗在线平台，以毫克为单位销售 18k 黄金：
你可以通过 Claude、Cursor 或 Copilot 查询实时每克金价、日、周和月价格历史记录，以及平台统计信息。

面向 AI Agent · 快速开始 · 功能 · 工具 · 须知 · 常见问题 · فارسی

面向 AI Agent

• **简介：**面向 milli.gold 公开价格、统计信息、费用、新闻和帮助页面的非官方 MCP 服务（模型上下文协议）。将伊朗黄金价格 API 封装为工具。
• 安装：uvx milligold-mcp 或 claude mcp add milligold -- uvx milligold-mcp。传输方式：stdio。需要 uv（Python 3.10+）。
• **认证：**无需认证，不需要 API 密钥或账户。可选设置 MILLIGOLD_MCP_PROXY（HTTP 代理 URL，或以逗号分隔的列表）；系统代理设置不会生效。
• **访问权限：**只读，因此调用任何工具前都无需确认。它无法登录、交易或读取钱包。
• **工具：**共 8 个，名称均以 mg_ 为前缀。常见调用顺序：mg_get_price -> mg_price_history；mg_trade_quote；mg_latest_posts 或 mg_help_topics -> mg_read。
• **适用场景：**用户询问 Milli.gold 当前的 18k 黄金每克价格、一天、一周或一个月内的价格走势、含手续费的买入或卖出成本、Milli.gold 的费用、最新黄金新闻，或如何使用 Milli（交付、转账、验证）。
• **不适用场景：**用户希望实际买卖黄金、需要全市场报价，或想查询美元、硬币或加密货币价格（请参阅 tgju-mcp）。
• **输出：**精简 JSON。Milli.gold 的报价单位为 18k 黄金每毫克的里亚尔价格；回复中也会提供每克里亚尔价格和每克土曼价格。时间均为德黑兰时间。
• 机器可读信息：server.json 和 iran-mcp 目录（TOOLS.md、servers.json、llms.txt）。

原因

Milli.gold 按毫克销售 18k 熔炼金，因此价格以每毫克报价，单位为 Rial。网站显示的是每克价格，这些数字很容易被误读，误差可达 10 倍或 1000 倍。使用 milligold-mcp 的 Agent 会直接从公开端点读取报价，并为你换算单位：

你： Milli.gold 现在的黄金价格是多少？本周是涨了还是跌了？

Agent： 调用 mg_get_price() -> mg_price_history(period="WEEKLY")

在 Milli.gold，1 克 18k 黄金售价为 26,890,000 Toman（每毫克 268,900 Rial）。过去一周的涨跌幅由 change_percent 显示，价格介于本周最低价与最高价之间。

_{示例价格取自网站对自身计价单位的说明；价格随时可能变化。}

功能

• Milli.gold 上 18k 黄金的实时价格：每毫克 Rial、每克 Rial 和每克 Toman，并附德黑兰时间戳
• 价格历史：过去一天、一周或一个月的价格，包含首末价格、最高价、最低价和涨跌幅百分比
• 平台统计数据：用户数、交易笔数、交易和持有的黄金（kg）、已销毁黄金（kg）、网点和代表
• 费用：买入、卖出、转移、交付黄金以及钱包提现的费用，实时读取自费用页面
• 交易报价：买入 N 克黄金（或使用 Toman 预算）的费用，或卖出可得金额，均包含手续费
• 新闻、杂志和帮助：最新文章（每日黄金、盎司和市场报告）、按关键词查找帮助文章，以及任意文章的全文
• 设计上仅支持读取：无需登录，不支持交易或钱包操作

示例提示词：

• “Milli.gold 现在每克 18k 黄金的价格是多少？”
• “显示 Milli.gold 过去一个月的黄金价格。最高价和最低价分别是多少？”
• “今天 Milli.gold 上的黄金是涨了还是跌了？请给出涨跌百分比。”
• “Milli.gold 报告的用户数和黄金数量是多少？”
• “在 Milli.gold 买 2 克黄金，包含手续费需要多少钱？”
• “如何从 Milli 交付实物黄金？费用是多少？”
• با ۵ میلیون تومان چند میلی طلا در میلی می‌توانم بخرم؟
• آخرین اخبار قیمت طلا در میلی چیست؟
• قیمت طلای ۱۸ عیار در میلی الان هر گرم چند تومان است؟
• نمودار قیمت طلا در میلی در یک هفته گذشته چطور بوده؟
• امروز قیمت طلا در میلی بالا رفته یا پایین آمده؟

快速开始

你需要安装 uv。无需 API 密钥或账户。

claude mcp add milligold -- uvx milligold-mcp

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

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

codex mcp add milligold -- uvx milligold-mcp

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

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

所有 8 个工具均为只读，并返回精简的 JSON。

工作原理

  AI agent  (Claude, Cursor, Copilot, ...)
      │
      │  MCP over stdio
      ▼
  milligold-mcp  (runs on your machine)
      │
      │  HTTPS
      └──────▶  milli.gold   price, price history, platform report, fees page, RSS feeds, help sitemap, posts

milligold-mcp 在本地运行，并读取 milli.gold 上无需登录即可访问的公开内容：三个 JSON 端点（实时价格、价格组件序列、总体报告）、费用页面、新闻、杂志和帮助 RSS 源、帮助站点地图以及文章页面。整个过程中没有托管服务，也不需要 API 密钥。

• 类似 Chrome 的客户端。 请求通过模拟 Chrome 的 HTTP 客户端发送，因为该网站由 ArvanCloud 提供防护。
• ArvanCloud 307 + Cookie。 ArvanCloud 有时会返回重定向到同一 URL 的响应并附带 Cookie。服务会重试一次并保留该 Cookie，因此你不会看到它。
• 15 秒缓存。 15 秒内的重复调用会复用之前的响应，而不会再次访问网站。
• 只读。 仅发送 GET 请求，且只访问 milli.gold。系统代理变量会被刻意忽略。

注意事项

• 单位。 网站以每毫克里亚尔为单位提供 price18，1 克 = 1000 毫克。因此，268,900 里亚尔/毫克 x 1000 = 268,900,000 里亚尔/克，里亚尔 / 10 = 26,890,000 托曼/克，这与网站上的“1 克 18K 金价格”一致。
• 德黑兰时间。 as_of 和历史记录中的 time 值均为德黑兰时间（UTC+3:30）。
• Milli.gold 自身报价。 这是该平台对 18K 熔化金的报价，不含税费或工费。它并非全市场报价，也不是 tgju 价格，因此与其他来源略有差异是正常的。
• 历史统计遵循网站口径。 一周或一个月的最高价、最低价和涨跌幅会计入当天峰值和实时价格，与 Milli.gold 页面上的计算方式一致。points 只会减少返回序列中的数据点，不会改变统计数据。
• 统计数据是公司公布的四舍五入总数，重量单位为千克。
• 交易报价仅供估算。 费用取最低费用与费用页面所列百分比计算结果中的较大值（今天为 1 毫克或 0.5 %）。不适用新用户费用减免和钱包提现费用，并且报价后、实际交易前价格可能会变动。
• 帖子。 只能获取最新帖子（约 20 篇新闻、10 篇杂志文章、10 篇帮助文章）；网站的订阅源不支持搜索或查看更早的页面。帮助文章通过其 URL 中的英文单词查找。文章文本为波斯语。
• 不提供的功能。 不支持买入或卖出，不支持登录，也不访问钱包或账户数据。

常见问题

配置

波斯语：Milli 黄金价格 MCP 服务

claude mcp add milligold -- uvx milligold-mcp

开发

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

工具位于 src/milligold_mcp/gold.py；每个工具都是带类型注解的异步函数，并附有说明文档，告知 Agent 何时使用。发布时：更新 pyproject.toml 和 server.json 中的版本，然后推送 v* 标签。

相关服务

• tgju-mcp：获取 tgju.org 上的美元、欧元、黄金、金币、加密货币和大宗商品价格
• iran-crypto-mcp：获取伊朗交易所的加密货币价格
• tsetmc-mcp：获取德黑兰证券交易所数据
• iran-mcp：伊朗服务 MCP 服务目录
• 收录于 mcpfarsi.ir，这是波斯语 MCP 市场

免责声明

本项目为非官方项目，与 Milli.gold 无关联，也未获其认可。它是只读的，并使用 milli.gold 的公开接口，这些接口可能在未通知的情况下发生变化。价格仅供参考，不构成财务建议。

作者

由 Sepehr Radmard（سپهر رادمرد）构建并维护。欢迎在 LinkedIn 上联系，或在 GitHub 上关注 @sepehr071，获取更多适用于伊朗网站的 MCP 服务，这些服务均列于 iran-mcp。如果它为你节省了时间，给仓库点个星可以帮助其他人找到它。

许可证

MIT