Fipiran Funds

io.github.sepehr071由 GitHub 帳號 sepehr071 發布v0.2.0更新於 Nov 7, 2026

Read-only Fipiran (fipiran.ir) data on Iranian mutual funds and ETFs: NAV, returns, size, managers.

已驗證STDIO僅桌面金融資料與分析

概覽

AI 產生的概覽

非官方唯讀 MCP 伺服器，提供 Fipiran 的伊朗共同基金與 ETF 資料，以及德黑蘭市場指數和個股行情。

可以做什麼
  • 依類型、管理公司、規模與報酬率搜尋並排序約 500 檔伊朗共同基金與 ETF，並列出各基金類型的平均報酬
  • 檢視單一基金完整資料，取得每日淨值、滾動報酬、規模、資金流、投資人結構或配息歷史
  • 並排比較 2 至 8 檔基金，並依管理資產規模排列基金管理公司
  • 瀏覽德黑蘭與 Farabourse 市場概況、65 個指數及其歷史、最近交易日個股行情與產業排名
適用情境
適合在使用者詢問哪些伊朗基金報酬最高、規模最大的黃金或固定收益基金、某檔基金的淨值或價格歷史、該基金與其類型平均的比較，或由誰管理時使用。
執行需求
透過 uvx 以 stdio 在本機執行，需要 uv 與 Python 3.10 以上版本。無需帳號或 API 金鑰。需要能連線 fipiran.ir 的網路，該網站僅回應伊朗網路線路；在伊朗境外須透過 FIPIRAN_MCP_PROXY 提供 HTTP 代理，系統代理設定會被忽略。
安裝前請注意
非官方專案，與 Fipiran 無關聯，讀取的是該網站基金頁面載入的同一份公開 JSON。唯讀，不含排名報告、自選清單或匯出等僅限登入使用的功能。資料不構成投資建議，過往報酬不代表未來表現。在伊朗境外需透過 FIPIRAN_MCP_PROXY 指定的代理存取。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Fipiran Funds，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

fipiran-mcp: Fipiran (فیپیران) Iranian mutual fund and ETF data MCP server for AI agents

fipiran-mcp is an unofficial, read-only MCP server that gives AI agents the public fund data of Fipiran (مرکز پردازش اطلاعات مالی ایران, fipiran.ir).
Its 11 tools search and rank Iranian mutual funds and ETFs (صندوق‌های سرمایه‌گذاری) by type, manager, size and return,
show one fund in full, return daily NAV, return, size, flow and investor-mix history, compare funds, rank fund managers, and cover the bourse: market overview, indices, stock quotes and industries. No API key or account is needed. It works in Claude, Cursor, Copilot and any other MCP client.

[PyPI] [License: MIT]

For AI agents

  • What: unofficial MCP server for fipiran.ir fund pages: search and ranking of about 500 Iranian mutual funds and ETFs, fund details, daily NAV / rolling-return / size history, side-by-side comparison, fund types with average returns, fund management companies.
  • Install: uvx fipiran-mcp or claude mcp add fipiran -- uvx fipiran-mcp. Transport: stdio. Needs uv (Python 3.10+).
  • Auth: none. Optional FIPIRAN_MCP_PROXY (HTTP proxy URL); system proxy settings are ignored.
  • Network: fipiran.ir answers Iranian internet lines only. Outside Iran, set FIPIRAN_MCP_PROXY to an Iranian proxy.
  • Access: read-only, no confirmation needed. Login-only Fipiran features (ranking reports, watchlists, exports) are not included.
  • Tools: 11, all prefixed 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. Typical sequence: fp_search_funds -> fp_fund / fp_history / fp_compare.
  • Use when: the user asks which Iranian funds returned most, the biggest gold or fixed-income funds, the NAV or price history of a fund, how a fund compares with its type average, or who manages a fund.
  • Output: compact JSON. Returns are percent per period (not annualised); sizes billion Toman; NAV rial per unit. Names are Persian.

Tools

ToolWhat it does
fp_search_fundsFind and rank funds by name, ticker, type, manager, size, age and return (daily to since-start).
fp_fund_typesFund types with fund count, total size, average returns and average asset allocation.
fp_fundOne fund in full: NAV, returns, size, allocation, investors, manager, auditor, custodian, website; optional past date.
fp_historyDaily NAV, rolling returns, net assets and unit flows, institutional/retail mix or dividends of one fund (up to 60 evenly spaced points).
fp_compare2 to 8 funds side by side.
fp_managersFund management companies by assets under management.
fp_indicesTehran and Farabourse market overview plus the 65 market and industry indices ranked by return.
fp_index_historyDaily value (with low and high) or rolling returns of one index.
fp_stocksSearch and rank listed shares of the last trading day: gainers, losers, most traded, by industry or market.
fp_stockOne share in full: quote, range, 5-level order book, retail vs institutional, period returns, optional OHLC history.
fp_industriesIndustries ranked by traded value, volume and trades on the last day.

Quick start

bash
uvx fipiran-mcp

Claude Desktop / Cursor config:

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

FAQ

Is it official? No. It reads the same public JSON the fipiran.ir fund pages load; it is not affiliated with Fipiran.
Is this investment advice? No. It is data. Past returns do not predict future returns; very young funds show distorted annual returns.
Why does it fail outside Iran? The site does not answer foreign IPs. Use FIPIRAN_MCP_PROXY.

Author: Sepehr Radmard (سپهر رادمرد), github.com/sepehr071, linkedin.com/in/sepehr-radmard. MIT license.

來源：README.md，提交 726b495

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

2
  1. v0.2.0最新Nov 7, 2026
  2. v0.1.0Nov 1, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分