Fipiran Funds

fipiran-mcp：AI エージェント向け Fipiran（فیپیران）のイラン投資信託・ETF データ MCP サーバー

fipiran-mcp は、Fipiran（مرکز پردازش اطلاعات مالی ایران、fipiran.ir）の公開ファンドデータを AI エージェントに提供する、非公式の読み取り専用 MCP サーバーです。
11 個のツールで、種類、運用会社、規模、リターン別にイランの投資信託と ETF（صندوق‌های سرمایه‌گذاری）を検索・ランキング表示できます。
個別ファンドの詳細、日次 NAV、リターン、規模、資金フロー、投資家構成の履歴を表示したり、ファンドを比較したり、ファンド運用会社をランキング表示したりできます。また、相場概況、指数、株価、業種など、証券取引所の情報にも対応しています。 API キーやアカウントは不要です。Claude、Cursor、Copilot、その他の MCP クライアントで利用できます。

AI エージェント向け

• 概要： 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 です。リターンは期間ごとのパーセンテージ（年率換算なし）、規模は 10 億トマン、NAV は 1 口あたりのリヤルです。名称はペルシャ語です。

ツール

ツール	機能
fp_search_funds	名称、ティッカー、種類、運用会社、規模、運用年数、リターン（日次から設定来まで）でファンドを検索・ランキング表示します。
fp_fund_types	ファンドの種類ごとに、ファンド数、総規模、平均リターン、平均資産配分を表示します。
fp_fund	1 つのファンドの詳細：NAV、リターン、規模、資産配分、投資家、運用会社、監査人、保管機関、ウェブサイト。過去の日付も指定できます。
fp_history	1 つのファンドの日次 NAV、期間リターン、純資産、口数の資金フロー、機関投資家／個人投資家の構成、または配当を表示します（均等間隔で最大 60 ポイント）。
fp_compare	2～8 個のファンドを並べて比較します。
fp_managers	運用資産額でファンド運用会社をランキング表示します。
fp_indices	テヘラン市場とファラボース市場の概況に加え、市場指数と業種指数 65 種をリターン順に表示します。
fp_index_history	1 つの指数の日次値（安値と高値を含む）または期間リターンを表示します。
fp_stocks	最終取引日の上場株式を検索・ランキング表示します：値上がり、値下がり、取引量上位、業種別、市場別。
fp_stock	1 銘柄の詳細：株価、値幅、5 段階の注文板、個人投資家と機関投資家の内訳、期間リターン、任意の 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 ライセンス。