mcpField
I
Iran Gold Prices

Iran Gold Prices

本地服务
github.com金融数据131 天前更新

关于 Iran Gold Prices

Iran Gold Prices 是供 Agent 使用的只读 MCP 服务,用于比较伊朗五个平台的 18K 黄金价格。它提供买卖价格、最便宜的买入和最佳卖出选项,以及 Milli.gold 的历史数据和统计信息。

主要功能

  1. 01比较五个平台的实时价格
  2. 02排列买入和卖出价格
  3. 03查看 Milli.gold 价格历史
  4. 04获取 Milli.gold 平台统计
  5. 05无需登录的只读访问

适用场景

  1. 01比较当前每克 18K 黄金价格
  2. 02查找买入价格最低的平台
  3. 03查看最佳卖出平台
  4. 04回顾 Milli.gold 的价格变化

MCP 相关

该 MCP 服务提供三个只读工具,用于价格比较、Milli.gold 历史数据和平台统计。它读取公开接口,无需账号或 API 密钥。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"sepehr071-iran-gold": {
"command": "uvx",
"args": [
"iran-gold-mcp"
],
"env": {
"IRAN_GOLD_MCP_PROXY": "<IRAN_GOLD_MCP_PROXY>"
}
}
}
}
启动命令uvx iran-gold-mcp
需要配置的环境变量
IRAN_GOLD_MCP_PROXYOptional HTTP proxy URL for the gold platform requests; system proxy settings are ignored. Also accepts a comma-separated list: one is used until it gets blocked or fails to connect, then the next.

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
pypiiran-gold-mcp0.2.0

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。

详细介绍

iran-gold-mcp:从 Claude、Cursor 或 Copilot 比较 Milli.gold、Wallgold、Melligold、Daric 和 Taline 的实时 18k 黄金价格

iran-gold-mcp:面向 AI Agent 的伊朗黄金平台实时金价

通过 AI Agent 比较 Milli.gold、Wallgold、Melligold、Daric 和 Taline 的 18k 黄金价格。
一款面向伊朗在线平台的非官方只读 MCP 服务,这些平台销售 18k 熔化金(طلای آب‌شده):
各平台每克黄金的实时买入价和卖出价、最便宜的买入渠道、最佳卖出渠道,以及 Milli.gold 的价格历史。

PyPI Python CI MCP Registry License: MIT

Install in Cursor Install in VS Code

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


面向 AI Agent

  • **简介:**一款用于查询五家伊朗在线黄金平台公开价格的非官方 MCP 服务(模型上下文协议):milli.gold、wallgold.ir、melligold.com、daric.gold 和 taline.ir。
  • 安装:uvx iran-gold-mcp 或 claude mcp add iran-gold -- uvx iran-gold-mcp。传输方式:stdio。需要 uv(Python 3.10+)。
  • **身份验证:**无需验证,不需要 API 密钥或账户。可选配置 IRAN_GOLD_MCP_PROXY(HTTP 代理 URL,或以逗号分隔的列表);系统代理设置会被忽略。
  • **访问权限:**只读,因此调用任何工具前都无需确认。它不能登录、交易或读取钱包。
  • **工具:**共 3 个,名称均以 gold_ 开头。典型调用顺序:gold_prices -> gold_milli_history。
  • **适用场景:**用户询问这些平台上 18k 熔化金每克的价格、哪里买入最便宜或卖出最好,或者 Milli.gold 的价格在一天、一周或一个月内如何变化时。
  • **不适用场景:**用户想买入或卖出黄金,或想查询美元、硬币或加密货币价格时(参见 tgju-mcp)。
  • 输出:紧凑型 JSON。gold_prices 的单位是 18k 黄金每克的土曼;gold_milli_history 的单位是每毫克的里亚尔。时间均为德黑兰时间。

为什么

每个伊朗黄金平台都有自己的报价和计价单位:Milli.gold 以每毫克里亚尔计价,其他平台以每克托曼计价;Daric 使用订单簿,买价和卖价分开;Taline 则只在其主页上显示价格。iran-gold-mcp 会同时读取这五个平台的数据,将价格换算为每克托曼并排序:

你: 现在 18K 黄金在哪里买最便宜?

Agent: 调用 gold_prices()

Milli.gold 最便宜,每克 25,935,000 托曼;其次是 Wallgold(26,078,000)、Melligold(26,133,565)、Daric(26,209,064)和 Taline(26,262,300)。未计入平台手续费。

价格取自 2026-10-27;价格随时可能变化。

示例提示词:

  • “比较 Milli、Wallgold、Melligold、Daric 和 Taline 的 18K 黄金每克价格。”
  • “现在卖出 2 克熔化黄金,哪个平台最合适?”
  • “显示 Milli.gold 过去一个月的金价。最高价和最低价是多少?”
  • قیمت طلای آب‌شده الان در کدام سایت ارزان‌تر است؟
  • قیمت هر گرم طلای ۱۸ عیار در میلی، وال‌گلد، ملی‌گلد، داریک و طلاین را مقایسه کن.

快速开始

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

Claude Code
claude mcp add iran-gold -- uvx iran-gold-mcp
Claude Desktop

设置 → 开发者 → 编辑配置,然后添加:

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

点击上方的 Install in Cursor,或将 Claude Desktop 配置块添加到 ~/.cursor/mcp.json。

VS Code (Copilot agent mode)

点击上方的 Install in VS Code,或添加到 .vscode/mcp.json:

{
  "servers": {
    "iran-gold": { "type": "stdio", "command": "uvx", "args": ["iran-gold-mcp"] }
  }
}
Codex CLI
codex mcp add iran-gold -- uvx iran-gold-mcp
其他客户端

这是一个标准的 stdio MCP 服务:运行 uvx iran-gold-mcp,或运行 pip install iran-gold-mcp 后再运行 iran-gold-mcp。

工具

这 3 个工具均为只读,并返回精简的 JSON。

工具功能
gold_prices比较 Milli.gold、Wallgold、Melligold、Daric 和 Taline 实时的 18K 黄金每克买入价和卖出价(托曼),按价格从低到高排序,并提供 best_to_buy 和 best_to_sell。未能响应的平台会列在 failed 下;其他平台仍会返回结果
gold_milli_history获取 Milli.gold 的 18K 黄金价格序列,可按日、周或月查询(period:DAILY、WEEKLY、MONTHLY;points:2-50,默认 24),并提供首值、末值、最高价、最低价和涨跌百分比
gold_milli_stats获取 Milli.gold 的主要数据:用户数、交易笔数、交易黄金量(kg)、用户余额(kg)、已熔化黄金量(kg)、分支机构和代表人数

注意事项

  • 买入和卖出。 buy 是你在该平台每克需要支付的价格,sell 是你卖出时每克可获得的价格。Milli.gold、Wallgold 和 Melligold 通常对两者报出同一个价格;Daric 使用订单簿,因此 buy 是最佳卖价,sell 是最佳买价。
  • 不含手续费。 平台会在价格之外收取交易手续费(通常约为 0.5 %)。
  • 平台价格,而非市场报价。 每个价格都是该平台对 18K 熔化黄金的报价,因此与 tgju 及其他平台相比可能略有差异。
  • 单位。 Milli.gold 以每毫克里亚尔报价;gold_prices 会进行换算(x100 = 每克托曼)。gold_milli_history 保留每毫克里亚尔单位。
  • 德黑兰时间。 as_of 和历史记录中的 time 均为德黑兰时间(UTC+3:30)。
  • 15 秒缓存。 15 秒内的重复调用会复用之前的结果。
  • Taline 需要伊朗境内的连接。 Taline 只在其主页上向伊朗境内的访客显示价格;其他地区的访问会将其列在 failed 下。在伊朗境外,请将 IRAN_GOLD_MCP_PROXY 设为伊朗 HTTP 代理。

常见问题

伊朗黄金平台价格有 API 吗?

没有官方 API。iran-gold-mcp 调用各平台网站使用的公开、无需登录的价格接口。

它和 milligold-mcp、tgju-mcp 有什么区别?

milligold-mcp 仅涵盖 Milli.gold。iran-gold-mcp 涵盖 Milli.gold 以及 Wallgold、Melligold、Daric 和 Taline,并对它们进行比较。tgju-mcp 提供 美元、硬币、黄金和加密货币的全市场行情。

它能帮我买卖黄金吗?

不能,这是有意为之。它不提供登录功能,只读取公开数据。

我需要伊朗 IP 或代理吗?

默认情况下不需要。如果你的网络请求遭到阻止,请将 IRAN_GOLD_MCP_PROXY 设置为 HTTP 代理。系统代理环境变量会被有意忽略。

配置

变量默认值含义
IRAN_GOLD_MCP_PROXY未设置平台请求可选的 HTTP 代理 URL。可使用逗号分隔的列表,依次尝试:某个代理被阻止或无法连接时,将改用下一个代理。系统代理设置会被忽略

波斯语: آب‌شده 黄金价格 MCP 服务

iran-gold-mcp 是一个非官方、只读的 MCP 服务,可从在线平台 Milli、Wallgold、Melligold、Daric 和 Taline 读取并比较 18 克拉 آب‌شده 黄金的实时价格。

  • 各平台每克黄金的买入价和卖出价(托曼),按从低到高排序,并标出最佳买入和卖出平台。
  • Milli 过去一天、一周和一个月的价格历史,以及 Milli 平台统计数据。
  • 只读:不买卖,也不登录账户。价格不包含平台手续费。
  • Taline 只向伊朗境内的访客显示价格;在伊朗境外,请将 IRAN_GOLD_MCP_PROXY 设置为伊朗代理。
claude mcp add iran-gold -- uvx iran-gold-mcp

开发

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

相关服务

  • milligold-mcp:仅适用于 Milli.gold
  • tgju-mcp:提供来自 tgju.org 的美元、欧元、黄金、硬币、加密货币和大宗商品价格
  • iran-mcp:伊朗服务 MCP 服务目录

免责声明

本项目为非官方项目,与 Milli.gold、Wallgold、Melligold、Daric 或 Taline 均无关联,也未获得其认可。本项目为只读工具,使用的公开接口可能随时变更,恕不另行通知。价格仅供参考,不构成财务建议。

作者

Sepehr Radmard:面向伊朗网络的开源 MCP 服务。LinkedIn:linkedin.com/in/sepehr-radmard

由 Sepehr Radmard(سپهر رادمرد)构建并维护。通过 LinkedIn 联系,或在 GitHub 关注 @sepehr071,了解更多面向伊朗网站的 MCP 服务;这些服务均列于 iran-mcp。

许可证

MIT

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。