Iran Fara Bourse

---

面向 AI Agent

• 简介： 面向 ifb.ir 的非官方 MCP 服务（模型上下文协议），提供所有国库券、伊斯兰债券和债券的到期收益率、含票息计划的证券详情、实时报价和订单簿、价格和收益率历史、IPO（已完成和即将推出）、承销、交易所公告、新闻和市场消息、市场摘要、含涨跌幅领先者和交易最活跃证券的实时市场监控、指数历史、停牌证券、增资和董事会转让、收益率曲线，以及伊斯兰证券的交易者信息。
• 安装： uvx ifb-mcp 或 claude mcp add ifb -- uvx ifb-mcp。传输方式：stdio。需要 uv（Python 3.10+）。
• 身份验证： 无。可选配置 IFB_MCP_PROXY（HTTP 代理 URL，或以逗号分隔的列表）；系统代理设置将被忽略。
• 访问权限： 只读。它无法交易、登录或更改任何内容，因此调用任何工具前都无需确认。
• 工具： 共 16 个，名称均以 ifb_ 为前缀。常见调用顺序：ifb_yields -> ifb_instrument / ifb_quote；ifb_search -> ifb_history；ifb_ipos(stage="pipeline")；ifb_announcements -> ifb_article。
• 适用场景： 用户询问哪只债券、伊斯兰债券或国库券收益最高或何时到期、某只债券支付什么以及何时支付、Fara Bourse 的价格或订单簿、即将推出或已完成的 IPO、某只证券停牌的原因，或市场表现如何时。
• 不适用场景： 问题涉及德黑兰证券交易所（tse.ir）、加密货币或黄金；或者用户希望下单时。
• 输出： 精简 JSON。价格以里亚尔计，收益率为年百分比，日期使用 Jalali 格式（1405/08/09）。文本为交易所原文（波斯语）。该网站仅可从伊朗网络访问。
• 机器可读信息： server.json。

原因

在 ifb.ir 上，“哪只在明年春季前到期的国库券收益率最高？”意味着打开收益率页面， 滚动浏览 1,000 行并手动排序。使用 ifb-mcp，Agent 一次调用即可回答：

你： 1405/12/01 前到期的国库券中，哪只收益率最高？

Agent： 调用 ifb_yields(kind="treasury", matures_before="1405/12/01", limit=3)

_{数据来自交易所网站所示内容；收益率由 Fara Bourse 根据最近一次交易计算。此信息不构成投资建议。}

功能

• 按收益率排列固定收益产品：国库券、伊斯兰债券、参与票据及其他债券，显示最新价格、到期日和 YTM，并可按收益率、到期日和代码筛选
• 查看票据详情：票面利率、到期日、发行人、担保人、承销商、做市商、完整付息计划和下一次付息
• 查看报价和图表：实时价格、涨跌幅、成交量、显示每个买价和卖价对应收益率的订单簿，以及包含 YTM 的每日历史数据
• 跟踪发行情况：已完成的 IPO（含价格和成交量，可按市场和定价方式筛选）、正在引入的公司、承销项目
• 查看交易所信息：按关键词和日期搜索官方公告、新闻和市场消息（停牌、开盘），并阅读文章
• 关注实时市场：按涨跌幅或金额排序，查看各板块每个代码的价格、涨跌幅和最佳买卖价；查看停牌代码及原因、始于 2009 年的指数历史、增资和板块转移
• 了解市场：指数、成交额、债券指数、各板块金额和涨跌幅领先者、拟合收益率曲线，以及伊斯兰证券的买卖情况
• 设计为只读：无需登录，不能下单

快速开始

你需要安装 uv。无需 API 密钥或账户。ifb.ir 可通过伊朗网络访问；从境外访问时，请将 IFB_MCP_PROXY 设置为伊朗代理。

claude mcp add ifb -- uvx ifb-mcp

Claude Desktop、Cursor 等：

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

工具

工具	用途
ifb_search	将代码或名称转换为证券 ID
ifb_yields	按 YTM 排列债券、伊斯兰债券和国库券，并可按到期日和价格筛选
ifb_instrument	查看票面利率、到期日、发行人、担保人和付息计划
ifb_quote	获取实时价格、成交量、订单簿和收益率
ifb_history	获取每日价格和 YTM
ifb_ipos	列出已完成、即将进行或正在进行的 IPO
ifb_underwritings	列出通过承销发行的证券
ifb_announcements	搜索公告、新闻和市场消息
ifb_article	阅读一篇新闻文章
ifb_market_summary	指数、成交额、债券指数、板块和涨跌幅领先者
ifb_yield_curve	政府债券、非政府债券和国库券的拟合收益率曲线
ifb_sukuk_flows	按投资者类型查看伊斯兰证券的每日买卖金额
ifb_market_watch	实时市场监控：各板块涨幅最高、跌幅最大和交易最活跃的证券，以及停牌代码
ifb_index_history	总指数、等权指数、价格指数和伊斯兰债券指数的每日历史数据，以及 1d/5d/21d/250d 涨跌幅
ifb_corporate_actions	带有配股期限的增资、板块转移、新上市，以及转至德黑兰证券交易所的证券
ifb_halted	当前停牌代码及其日期和原因，以及被标记为披露不充分的发行人

常见问题

这是官方工具吗？ 不是。它读取 ifb.ir 的公开页面和网络服务，与 Iran Fara Bourse 没有隶属关系。

为什么代码末尾有数字？ 交易所会在多个板块挂牌同一票据（کارون0731、0732）。请从 ifb_yields 或 ifb_search 获取 id。

是否包含市场监控？ 不包含实时排名网格；网站通过推送连接填充该网格。报价来自网站的 JSON 服务。

波斯语

许可证

MIT