Iran Mercantile Exchange

Name: Iran Mercantile Exchange
Author: sepehr071

本地服务

github.com金融数据03 天前更新

代码仓库访问官网

关于 Iran Mercantile Exchange

这是一个非官方、只读的 MCP 服务，为 AI Agent 提供 Iran Mercantile Exchange 的商品交易、供应和价格公开数据，也涵盖市场总量、期权、存托凭证、基金及交易所新闻。

主要功能

01商品交易价格和成交量
02后续供应报价与价格历史
03市场总量和生产商排行
04期权、存托凭证和商品基金
05交易所新闻及周报链接

适用场景

01查看某类商品近期交易情况
02追踪指定日期范围内的价格变化
03查询后续交易时段的供应商品
04查看市场总量或商品存托凭证

MCP 相关

通过 14 个只读工具向 MCP 客户端提供 Iran Mercantile Exchange 的公开数据。它不能下单，也无需账号或 API 密钥。

配置

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

mcp.json · 通用配置

{
  "mcpServers": {
    "sepehr071-ime": {
      "command": "uvx",
      "args": [
        "ime-mcp"
      ],
      "env": {
        "IME_MCP_PROXY": "<IME_MCP_PROXY>"
      }
    }
  }
}

启动命令uvx ime-mcp

需要配置的环境变量

IME_MCP_PROXYOptional HTTP proxy URL for the ime.co.ir 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+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

pypiime-mcp0.2.0stdio

工具

还没有获取到工具列表

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

详细介绍

ime-mcp：面向 AI Agent 的伊朗商品交易所（بورس کالای ایران）MCP 服务

ime-mcp 是一款非官方、只读的 MCP 服务，可向 AI Agent 提供伊朗商品交易所（IME，ime.co.ir）的公开交易和供应数据。
它提供 14 个工具，用于查询大宗商品交易（钢铁、石化产品、水泥、石油产品、金属、农产品）的价格和成交量，
即将发布的供应报价、每日价格序列、按生产商和经纪商划分的排名、市场和交易大厅汇总、美元结算汇率，
期权行情、黄金、白银及其他存托凭证、黄金基金，以及交易所新闻和周报。
无需 API 密钥或账户。可用于 Claude、Cursor、Copilot 及其他任何 MCP 客户端。

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

面向 AI Agent

功能： ime.co.ir（伊朗商品交易所）的非官方 MCP 服务（模型上下文协议）；涵盖实物市场交易（工业和矿产、石化产品和石油产品、水泥、附属市场、基什出口交易大厅）、供应报价（含溢价和出口）、价格历史、按生产商或经纪商划分的排名、市场汇总、美元汇率、新闻、周报链接、期权行情、存托凭证（金条、金币、白银……）、预售和大宗商品基金。
安装： uvx ime-mcp 或 claude mcp add ime -- uvx ime-mcp。传输方式：stdio。需要 uv（Python 3.10+）。
身份验证： 无。可选设置 IME_MCP_PROXY（HTTP 代理 URL 或以逗号分隔的列表）；系统代理设置会被忽略。
访问权限： 只读。无法交易或下单，因此调用任何工具前都无需确认。
工具： 共 14 个，名称均以 ime_ 开头。典型调用顺序：ime_categories -> ime_price_history / ime_trades / ime_supply；ime_producers -> ime_trades；ime_options -> ime_options(contract=...)；ime_certificates -> ime_certificates(commodity=...)。
适用场景： 用户询问交易所的成交情况、钢材、螺纹钢、热轧板、聚合物、沥青或水泥的价格、下一场交易将供应什么、成交规模、交易所美元汇率、期权合约，或金条、金币和白银存托凭证价格时。
不适用场景： 有关股票市场（TSETMC）、房地产和汽车交易的问题；本服务不涵盖这些内容。
输出： 精简 JSON。日期使用波斯历（1405/08/09）；也接受公历输入。价格单位为里亚尔（按吨计量的商品以公斤为单位：请查看 unit）；value_k_rial 表示千里亚尔；汇总值以百万里亚尔计；value_rial（期权、存托凭证、基金）单位为里亚尔。文本为波斯语。
机器可读信息： server.json 和 iran-mcp 目录。

为什么

IME 网站仅通过筛选表单和分页表格展示交易和供应情况。“本月热轧板卷价格走势如何？”意味着要选择组别、子组别和日期范围，然后逐行查看表格。使用 ime-mcp，Agent 只需调用一次：

你：从阿班月初至今，热轧板卷价格走势如何？

Agent： 调用 ime_price_history(search="ورق گرم", date_from="1405/08/01")

Kavian 热轧板卷（KAS-HS00000-00）于 08/02 以 1,305,425 Rial/kg 成交（3,740 t），于 08/03 以 1,296,722 成交（1,430 t），于 08/06 以 1,370,586 成交（2,310 t），于 08/09 以 1,352,960 成交（110 t）。

_{数据来自 2026-10-31 的实时调用。}

功能

交易：查询指定日期范围内在现货市场、子市场（بازار فرعی）或基什出口大厅的所有交易，包括加权收盘价、最低价和最高价、供应量、需求量、成交量、成交额、生产商、合约类型、交割信息和经纪商；可按商品组、生产商或文本筛选
供应报价（اطلاعیه عرضه）：查看后续交易场次待售商品的信息，包括数量、基准价格、交割地点和日期、结算方式及经纪商
价格历史：查询最长 45 天内每个代码的每日最低价、最高价、成交量加权平均价和成交量
市场总额：查询一段时间内按市场和大厅划分的成交额和成交量，以及美元结算汇率；查询某个市场的逐日总额
排名：按成交额排列生产商、商品、经纪商或大厅，并显示市场份额
期权：查询期权交易板（黄金、金币、黄金基金、藏红花期货），包括结算价和未平仓量；查询单个合约的历史记录
证书和基金：查询金条、金币、白银、铜和钢铁存托凭证、藏红花凭证、Salaf 和黄金基金的每日信息及买卖盘
组别和生产商：查询交易所的商品组树状结构和生产商 ID
新闻和报告：查看最新公告和每周报告 PDF 链接

示例提示词：

“今天交易所最大的几笔交易是什么？”
“过去两周螺纹钢价格走势如何？”
“下周交易所将供应哪些来自 Mobarakeh Steel 的商品？”
“本周现货市场按大厅划分的成交额是多少？”
过去一个月，商品交易所的热轧板卷价格有何变化？
明天商品交易所将供应哪些产品？

快速开始

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

Claude Code

claude mcp add ime -- uvx ime-mcp

Claude Desktop

前往“Settings” → “Developer” → “Edit Config”，然后添加：

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

Cursor、VS Code、Codex CLI、Gemini CLI、Windsurf

在客户端的 MCP 设置中使用相同的命令（uvx ime-mcp），例如 codex mcp add ime -- uvx ime-mcp，也可以将上面的 Claude Desktop 配置块添加到 ~/.cursor/mcp.json。

其他客户端

这是一个标准的 stdio MCP 服务：运行 uvx ime-mcp，或执行 pip install ime-mcp 后运行 ime-mcp。

## 工具

分组 ID 来自 ime_categories，生产商 ID 来自 ime_producers。日期格式为 1405/08/09 或 2026-10-31；默认值为今天（德黑兰时间）。日期范围最长为 45 天。

工具	功能
`ime_categories`	列出交易所的商品组：主组、组和子组，并提供其 ID
`ime_producers`	按名称查找在交易所挂牌的生产商和供应商，以获取交易和供应工具所需的生产商 ID
`ime_trades`	列出指定日期范围内的商品交易（价格、成交量、供应量、需求量、买方经纪商），并提供合计
`ime_supply`	列出供应报价（اطلاعیه عرضه）：各场次待售商品、成交量和基准价格（实物、溢价或出口）
`ime_price_history`	列出指定日期范围内各代码的每日价格序列（最低价、最高价、成交量加权平均价、成交量）
`ime_market_summary`	列出指定日期范围内全交易所的交易额和成交量：按市场、按实物市场大厅分类，并提供 USD 汇率
`ime_daily_totals`	列出指定日期范围内某个市场逐日的交易额和成交量（网站上的市场图表）
`ime_news`	列出交易所新闻档案中的最新新闻和公告：标题、导语、日期和链接
`ime_trade_stats`	按指定日期范围内的交易额对生产商、商品、经纪商或大厅进行排名，并列出各自的市场份额
`ime_weekly_reports`	列出交易所的每周市场报告（گزارش هفتگی），按时间从新到旧排列，并提供每份报告的 PDF 链接
`ime_options`	黄金、金币、黄金基金和藏红花期货的期权（اختیار معامله）：某日的行情板或某份合约的历史记录
`ime_securities`	列出交易所金融市场代码的每日交易：salaf、商品存托凭证和商品基金
`ime_certificates`	列出连续商品存托凭证（گواهی سپرده پیوسته）：金条、金币、白银、铜、钢等
`ime_board`	市场行情板（cdn.ime.co.ir），显示基金、凭证和 salaf 的最佳买价和卖价

所有 14 个工具均标注为 readOnlyHint: true。

工作原理

  AI agent  (Claude, Cursor, Copilot, ...)
      │
      │  MCP over stdio
      ▼
  ime-mcp  (runs on your machine)
      │
      │  HTTPS
      └──────▶  www.ime.co.ir   imedata.asmx, auction.ashx, export.ashx, news archive

ime-mcp 在本地运行，并调用 ime.co.ir 页面使用的相同公共端点，中间没有托管服务，也不需要 API 密钥。请求通过模拟 Chrome 的客户端发送。它每次最多并发发送 3 个请求，并加入少量随机延迟；答案缓存 2 分钟；失败的请求最多重试 2 次；并且只与 www.ime.co.ir、dataapi.ime.co.ir（黄金及其他存托凭证）和 cdn.ime.co.ir（买卖盘行情板）通信。

注意事项

伊朗网络。 ime.co.ir 在伊朗境内可以正常响应。测试时，从土耳其出口节点访问会超时；请使用伊朗直连线路，或将 IME_MCP_PROXY 设置为可访问该网站的代理。
网站混淆了实物市场和子市场的列表。 其交易列表服务会保留每个日期范围的第一个回答，之后忽略市场标记。服务会请求一个新的（扩展后的）日期范围并检查大厅，最多重试 6 次，因此响应较慢属于正常情况。
单位。 按吨计价的商品，其价格单位为每千克里亚尔。value_k_rial 表示价格 × 成交量，单位为千里亚尔；市场汇总单位为百万里亚尔；期权、证券、凭证和行情板中的 value_rial 单位为里亚尔。
交易日。 周六至周三，以及部分周四；其他日期不会返回数据。
未涵盖的内容： 房地产、汽车交易和股票相关子站点均为独立的 ime.co.ir 子站点。统计报告档案（market-reports.html）需要提交表单，因此不会读取；每周报告仅提供 PDF 链接，不解析 PDF。子市场列表不含价格或交易额，仅含基准价格、供应量、需求量和成交量。
波斯语数据。 名称、大厅、合约和新闻均以波斯语返回。

常见问题

有官方的 IME API 吗？

IME 仅通过其网站发布数据。ime-mcp 是一个独立的非官方 MCP 服务，会调用网站表格和图表背后的公开端点，并返回精简的 JSON。

需要 API 密钥或账号吗？

不需要。使用 uvx ime-mcp 安装后，即可在伊朗网络环境中运行。

能显示实时价格吗？

它会显示网站公布的交易，包括网站列出的当前交易时段数据，但不是逐笔行情数据源。

能下单吗？

不能。它只读取公开数据。

如何调试 Agent 看到的内容？

npx @modelcontextprotocol/inspector uvx ime-mcp

配置

变量	默认值	含义
`IME_MCP_PROXY`	unset	ime.co.ir 请求可选的 HTTP 代理 URL；系统代理设置会被忽略。逗号分隔的列表会逐个使用：某个代理被拦截或无法连接时，下一个代理会接替

波斯语：伊朗商品交易所 MCP 服务

ime-mcp 服务是一个面向伊朗商品交易所的非官方只读 MCP 服务。借助它，你的 AI 助手可以查看网站上的相同公开数据：交易、价格、即将进行的供应和市场统计数据。

功能

交易：实体市场、次级市场和基什出口交易大厅在任意历史时间段内的交易数据，包括收盘价（加权平均价）、最低价和最高价、供应量、需求量、成交量、成交额、生产商和经纪商。
供应公告：即将举行的交易时段及其供应量和基准价格。
价格历史：任意代码长达 45 天的每日价格。
市场统计：按市场和交易大厅统计，以及交易所结算美元汇率。
新闻和商品交易所周报。

注意： 仅供读取，不会下单；无需 API 密钥；商品交易所网站仅在伊朗网络中响应；硬币交易和黄金凭证位于另一个子网站，不在覆盖范围内。

安装（请先安装 uv）。在 Claude Code 中：

claude mcp add ime -- uvx ime-mcp

示例问题

“过去一个月商品交易所的热轧板价格有什么变化？”
“明天商品交易所会供应哪些产品？”
“今天商品交易所最大的交易有哪些？”

开发

git clone https://github.com/sepehr071/ime-mcp && cd ime-mcp
uv sync
uv run ruff check . && uv run ruff format --check .
uv run python -m pytest -q          # offline unit tests on recorded IME answers
uv run python -m pytest -m live -q  # calls the real ime.co.ir (needs an Iranian line)
uv build

实体市场工具位于 src/ime_mcp/ime.py，衍生品和证券工具位于 src/ime_mcp/securities.py；每个工具都是带有类型标注的异步函数，并附有说明何时使用它的文档字符串。欢迎提交问题和 PR。

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

免责声明

本项目为非官方项目，与伊朗商品交易所无关联，也未获其认可。它是只读的，使用 ime.co.ir 网站的公开端点，这些端点可能随时变更，恕不另行通知。本项目不构成投资建议；采取行动前请在交易所核实价格。

作者

由 Sepehr Radmard（سپهر رادمرد）构建并维护。可在 LinkedIn 上联系，或在 GitHub 关注 @sepehr071，获取更多面向伊朗网站的 MCP 服务。它们都列在 iran-mcp 中。如果本项目为你节省了时间，请给仓库点个星，帮助更多人发现它。

许可证

MIT

支持 Markdown

登录后评论

基本信息

作者: sepehr071
语言: python
版本: 0.2.0
传输方式: stdio
收录时间: 2026年11月1日
最近更新: 3 天前
官方 Registry: io.github.sepehr071/ime-mcp

报告问题

第一次接触 MCP？

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

阅读入门指南

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

Iran Mercantile Exchange

关于 Iran Mercantile Exchange

主要功能

适用场景

MCP 相关

配置

工具

详细介绍

ime-mcp：面向 AI Agent 的伊朗商品交易所（بورس کالای ایران）MCP 服务

面向 AI Agent

为什么

功能

快速开始

工作原理

注意事项

常见问题

配置

波斯语：伊朗商品交易所 MCP 服务

开发

相关服务

免责声明

作者

许可证

评论

第一次接触 MCP？

MCP（Model Context Protocol）是什么？

MCP 服务和客户端有什么区别？

本地服务与远程服务怎么选？

如何在 Claude、Cursor 等客户端中安装服务？

收录的项目经过审核吗？“认证”标识代表什么？

我维护的项目已被收录，怎样认领？