Iran Brokers Market Data

iran-brokers-mcp：面向 AI Agent 的伊朗经纪商（کارگزاری بورس）市场数据 MCP 服务

iran-brokers-mcp 是一款非官方的只读 MCP 服务，可让 AI Agent 通过两家伊朗经纪商 Mofid Securities（کارگزاری مفید，emofid.com）和 Agah（کارگزاری آگاه，agah.com）读取德黑兰证券交易所市场数据。
其 22 个工具涵盖股票、ETF 和基金（صندوق سرمایه‌گذاری）、期权（آپشن）、债券和伊斯兰债券（اوراق）、金币（سکه）和货币、筛选器、Codal 公告及教育文章，覆盖德黑兰证券交易所（بورس تهران）和 Fara Bourse（فرابورس）。
无需 API 密钥或经纪商账户，可在 Claude、Cursor、Copilot 及任何其他 MCP 客户端中使用。

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

最后于 2026-11-01 对照 Mofid 和 Agah 的实时 API 完成验证。

面向 AI Agent

• **功能：**面向 Mofid 和 Agah 的非官方 MCP 服务（模型上下文协议），提供代码搜索、股票卡片、OHLC 蜡烛图和每日历史数据、市场快照、36 项 Mofid 排名、Agah 市场观察和筛选器、包含价格与 NAV 对比的 ETF、基金详情／历史数据／比较、期权链和合约、债券和国库券、货币／硬币／黄金／大宗商品价格及历史数据、Codal 文件、估值评分、技术指标汇总、教育文章和课程。
• 安装：uvx iran-brokers-mcp 或 claude mcp add iran-brokers -- uvx iran-brokers-mcp。传输方式：stdio。需要 uv（Python 3.10+）。
• **身份验证：**无需身份验证。可选设置 IRAN_BROKERS_MCP_PROXY（为所有请求指定一个 HTTP 代理 URL，或以逗号分隔的代理列表）；系统代理设置将被忽略。
• **访问权限：**只读市场数据。无法登录、读取投资组合、现金或订单，也无法下单、修改或取消订单，或付款。调用任何工具前无需确认。
• **工具：**共 22 个，名称均以 br_ 为前缀。典型调用顺序：br_search -> br_stock / br_history；br_market -> br_market_top 或 br_stocks；br_etfs -> br_stock 或 br_fund；br_screener；br_rates；br_announcements；br_learn -> br_learn(ref=...)。
• **source 参数：**每个来源都会在自己的区块中返回结果（{"mofid": ..., "agah": ...}）。使用 all 时，失败的来源会显示 {"error": ...}，另一个来源仍会返回结果。由于字段各不相同，结果区块不会合并成同一行。
• **适用场景：**用户询问伊朗市场的股票、基金、期权、指数、黄金或美元价格、排名或筛选结果、图表、公司的 Codal 文件，或证券交易所相关知识时。
• **不适用场景：**用户想要交易、查看自己的投资组合，或需要实时逐笔行情数据时（此处所有数据均为轮询快照）。如需原始交易所数据，请使用 tsetmc-mcp；如需完整财务报表，请使用 codal-mcp。
• **输出：**紧凑的 JSON。价格单位为 Rial（除以 10 即为 Toman）。文本为波斯语。
• 机器可读信息：server.json 和 iran-mcp 目录。

功能

• **在 Claude 中获取德黑兰证券交易所数据：**查找代码、读取价格卡片（P/E、EPS、NAV、买卖资金流、订单簿）、查看从 1 分钟到周线的蜡烛图，以及包含指数和涨跌活跃股票的市场快照
• **通过 AI Agent 比较伊朗 ETF：**列出 ETF 及其价格、NAV 和溢价差（Mofid 有 375 只 ETF，Agah 有 331 只已上市 ETF），然后查看某只基金的详情、NAV 历史数据，或比较多只基金
• 读取期权链（看涨和看跌合约）以及单个合约的详情
• 使用 Agah 筛选器按任意列筛选股票、ETF 或基金，或查看 Mofid 的 36 项排名（涨幅最高、交易额、排队情况等）
• 债券、sukuk 和国库券及其收益率，以及货币、加密货币、硬币（سکه）、黄金和大宗商品价格及历史数据
• Codal 公告，可按公司、类型和日期筛选，还包括通知、新闻和研究 PDF
• **估值和技术评分：**理论价格、基本面和技术面评分，以及按股票或行业汇总的指标
• **教育内容：**Mofid 博客、Agah Pedia 文章和 Agah Academy 课程
• **默认只读：**无需登录、无需下单、无需破解验证码

示例提示词：

• “获取今天的德黑兰证券交易所摘要：指数、涨跌活跃股票，以及美元和硬币价格。”
• “按价格与 NAV 的对比情况比较伊朗 ETF，并指出溢价最大的 ETF。”
• “显示 Foolad 的期权链，以及一个看涨合约的详情。”
• “本周哪些股票的 P/E 最低且资金流为正？”
• 比较黄金基金的价格和 NAV 比率。
• 今天证券交易所中买入排队最长的是哪些代码？
• 提供 Foolad 代码最新的 Codal 公告。

快速开始

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

claude mcp add iran-brokers -- uvx iran-brokers-mcp

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

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

工具

合并工具接受 source 参数：mofid、agah 或 all（默认值见方括号）。单一来源工具会注明使用的券商。

所有工具均为只读。如果你使用的是独立的 mofid-mcp 或 agah-mcp 服务：mf_search 和 ag_search -> br_search；mf_symbol、mf_depth、ag_stock -> br_stock；mf_history、ag_stock_history -> br_history；mf_market_summary、ag_market_pulse、ag_market_overview -> br_market；mf_industries、ag_industries -> br_industries；mf_index、ag_index_history -> br_index；mf_etfs -> br_etfs；mf_learn、mf_learn_categories、ag_articles、ag_article、ag_academy -> br_learn；mf_fx_gold、mf_rate_history -> br_rates；ag_fund、ag_fund_trend、ag_fund_compare -> br_fund；ag_options、ag_option -> br_options；其他工具名称前加 br_ 前缀即可（mf_quote -> br_quotes）。

限制

• 不提供投资组合、订单或现金信息。 这些功能需要登录券商账户（EasyTrader、AsaTrader）；本项目不会登录，也无法下单，并且尚未实现这些功能。
• Agah Pedia 和 Academy 仅能通过伊朗网络访问（从境外访问 pediaapi.agah.com、academyapi.agah.com 会超时）。错误信息会说明这一点；br_learn 中 Mofid 相关的部分仍可正常响应。请勿在它们前面设置境外代理。
• Mofid 依赖 Bourse View 网关的 accept-info 请求头（该请求头根据服务器时钟生成；客户端会在收到 401 响应时重新同步）。如果网站更改了此项检查，Mofid 工具会返回 HTTP 401 错误，而 Agah 相关功能仍可正常使用。
• 数据为定时轮询的快照，缓存时间为 30 到 60 秒，数据可能延迟或未经审计；市场在星期六至星期三约 09:00-12:30（德黑兰时间）交易。
• 两个数据源对基金使用不同的 ID（Mofid 使用 ISIN，Agah 使用类似 14010557380_A01 的国家代码），字段也各不相同，因此合并工具会并排显示两边的数据。
• 价格单位为里亚尔；除以 10 即为土曼。日期以各网站为准。

常见问题

配置

波斯语：面向 AI 助手的 مفید 和 آگاه 券商 MCP 服务

claude mcp add iran-brokers -- uvx iran-brokers-mcp

开发

git clone https://github.com/sepehr071/iran-brokers-mcp && cd iran-brokers-mcp
uv sync
uv run ruff check . && uv run ruff format --check .
uv run python -m pytest -q          # offline unit tests on recorded responses
uv run python -m pytest -m live -q  # live pass against Mofid and Agah
uv build

发布版本：在 pyproject.toml 和 server.json 中更新版本号，然后推送一个 v* 标签。GitHub Actions 会将其发布到 PyPI。欢迎提交问题和 PR。

相关服务

• tsetmc-mcp：提供德黑兰证券交易所价格、订单簿、个人与法人交易数据及指数
• codal-mcp：提供 Codal 公告和财务报表
• iran-gold-mcp：提供伊朗平台上的实时 18K 黄金价格
• iran-mcp：伊朗服务 MCP 服务的目录

免责声明

本项目为非官方项目，与 Mofid Securities 或 Agah 无关，也未获得其认可。服务为只读，并使用其网站的公开接口，这些接口可能在不另行通知的情况下发生变化。数据仅供参考，存在延迟且未经审计。本文内容不构成投资建议。

作者

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

许可证

MIT