mcpField
F
Fipiran Funds

Fipiran Funds

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

关于 Fipiran Funds

这是一款非官方、只读的 MCP 服务,为 AI Agent 提供 Fipiran 上伊朗共同基金和 ETF 的公开数据。它支持基金研究与比较,也提供市场、指数和股票数据。

主要功能

  1. 01搜索并排行基金
  2. 02查看基金详情与 NAV 历史
  3. 03比较基金和基金类型
  4. 04按管理资产排行基金管理公司
  5. 05浏览指数、股票和行业

适用场景

  1. 01按类型、规模或回报查找基金
  2. 02查看基金的 NAV 与回报历史
  3. 03比较基金与同类产品
  4. 04查询市场指数和股票报价

MCP 相关

通过 stdio 向 MCP 客户端提供 11 个只读工具,用于访问 Fipiran 的公开基金、管理公司、市场、指数、股票和行业数据。

配置

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

mcp.json · 通用配置
{
"mcpServers": {
"sepehr071-fipiran": {
"command": "uvx",
"args": [
"fipiran-mcp"
],
"env": {
"FIPIRAN_MCP_PROXY": "<FIPIRAN_MCP_PROXY>"
}
}
}
}
启动命令uvx fipiran-mcp
需要配置的环境变量
FIPIRAN_MCP_PROXYOptional HTTP proxy URL for the Fipiran requests; system proxy settings are ignored. The site answers Iranian lines only.

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

安装包
pypifipiran-mcp0.2.0

工具

还没有获取到工具列表

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

详细介绍

fipiran-mcp:面向 AI Agent 的 Fipiran(فیپیران)伊朗共同基金和 ETF 数据 MCP 服务

fipiran-mcp 是一个非官方、只读的 MCP 服务,为 AI Agent 提供 Fipiran(مرکز پردازش اطلاعات مالی ایران,fipiran.ir)的公开基金数据。
它的 11 个工具可按类型、管理方、规模和回报搜索并排名伊朗共同基金和 ETF(صندوق‌های سرمایه‌گذاری),
展示单只基金的完整信息,返回每日 NAV、回报、规模、资金流和投资者构成历史数据,对比基金,为基金管理公司排名,并涵盖证券交易所:市场概览、指数、股票行情和行业。 无需 API 密钥或账户。可用于 Claude、Cursor、Copilot 和任何其他 MCP 客户端。

PyPI License: MIT

面向 AI Agent

  • 功能: 面向 fipiran.ir 基金页面的非官方 MCP 服务:搜索并排名约 500 只伊朗共同基金和 ETF,提供基金详情、每日 NAV / 滚动回报 / 规模历史数据、并排对比、基金类型及平均回报,以及基金管理公司信息。
  • 安装: uvx fipiran-mcp 或 claude mcp add fipiran -- uvx fipiran-mcp。传输方式:stdio。需要 uv(Python 3.10+)。
  • 身份验证: 无。可选设置 FIPIRAN_MCP_PROXY(HTTP 代理 URL);系统代理设置将被忽略。
  • 网络: fipiran.ir 仅响应伊朗境内的互联网线路。在伊朗境外,请将 FIPIRAN_MCP_PROXY 设为伊朗代理。
  • 访问权限: 只读,无需确认。不包含仅限登录使用的 Fipiran 功能(排名报告、观察列表、导出)。
  • 工具: 共 11 个,名称均以 fp_ 开头:fp_search_funds、fp_fund_types、fp_fund、fp_history、fp_compare、fp_managers、fp_indices、fp_index_history、fp_stocks、fp_stock、fp_industries。典型调用顺序:fp_search_funds -> fp_fund / fp_history / fp_compare。
  • 适用场景: 用户询问回报最高的伊朗基金、规模最大的黄金或固定收益基金、某只基金的 NAV 或价格历史、某只基金与所属类型平均水平的比较,或基金的管理方时。
  • 输出: 紧凑的 JSON。回报按周期以百分比表示(非年化);规模单位为十亿 Toman;NAV 单位为每份额 rial。名称为波斯语。

工具

工具功能
fp_search_funds按名称、代码、类型、管理方、规模、成立年限和回报(从每日到成立以来)查找并排名基金。
fp_fund_types提供基金类型、基金数量、总规模、平均回报和平均资产配置。
fp_fund展示一只基金的完整信息:NAV、回报、规模、资产配置、投资者、管理方、审计方、托管方、网站;可选指定过去的日期。
fp_history提供一只基金的每日 NAV、滚动回报、净资产和份额流、机构/零售投资者构成或股息(最多 60 个等间隔数据点)。
fp_compare并排对比 2 到 8 只基金。
fp_managers按管理资产规模列出基金管理公司。
fp_indices提供德黑兰和 Farabourse 市场概览,以及按回报排名的 65 个市场和行业指数。
fp_index_history提供一个指数的每日值(含最低值和最高值)或滚动回报。
fp_stocks搜索并排名最近一个交易日的上市股票:涨幅榜、跌幅榜、成交最活跃股票,以及按行业或市场筛选的股票。
fp_stock展示一只股票的完整信息:行情、价格区间、五档订单簿、零售与机构投资者情况、分时段回报,可选 OHLC 历史数据。
fp_industries按最近一个交易日的成交金额、成交量和成交笔数为行业排名。

快速开始

uvx fipiran-mcp

Claude Desktop / Cursor 配置:

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

常见问题

这是官方的吗? 不是。它读取的是 fipiran.ir 基金页面加载的同一份公开 JSON;与 Fipiran 无关。
这是投资建议吗? 不是。这只是数据。过往收益不能预测未来收益;成立时间很短的基金,其年化收益会出现失真。
为什么在伊朗境外无法使用? 该网站不响应外国 IP。请使用 FIPIRAN_MCP_PROXY。


作者:Sepehr Radmard(سپهر رادمرد),github.com/sepehr071,linkedin.com/in/sepehr-radmard。MIT 许可证。

评论

支持 Markdown

第一次接触 MCP?

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

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