bahi-mcp

bahi-mcp

AI アシスタント（Claude、Cursor、VS Code など）が、インドの投資信託データ、NSE/BSE の市場データ、金融計算ツールを利用できる MCP サーバーです。

Bahi（बही）は、インドで伝統的に使われている帳簿です。このサーバーが数値を正確に保つため、アシスタントが推測に頼ることはありません。

免責事項： bahi-mcp は、公開データソース（mftool ライブラリ経由の AMFI、および株式については Yahoo Finance）と、ユーザーが指定する前提条件に基づいて情報と計算結果を提供します。投資や税務に関する助言ではなく、作者は SEBI 登録アドバイザーではありません。データには遅延や誤りが含まれる可能性があり、税制も変更されます。判断を下す前に、必ずご自身で確認してください。

質問できること

• 「この3つのフレキシキャップファンドについて、3年間のリターン、ボラティリティ、最大ドローダウンを比較してください。」
• 「このファンドのローリング3年リターンが12％を上回ったのは、どのくらいの頻度ですか？」
• 「2020年1月からスキーム119551に毎月₹10,000を投資していた場合、今日の評価額はいくらで、XIRRはいくらですか？」
• 「Nifty の現在値はいくらで、RELIANCE の過去1年間の値動きはどうでしたか？」
• 「この株式ファンドを14か月後に売却して、利益が₹2 lakhある場合、税額はいくらですか？」
• 「今日の支出が毎月₹60,000の場合、55歳で退職するにはいくらの資産が必要ですか？」

ツール

投資信託データ（AMFI）

ツール	機能
search_schemes	スキームを名前で検索し、AMFI スキームコードを返します
get_scheme_quote	スキームコードに対応する最新の NAV と相場情報を取得します
get_scheme_details	運用会社、種類、カテゴリー、設定日を取得します
get_nav_history	任意の日付範囲を指定して NAV 履歴を取得します（応答が大きくなりすぎないよう上限があります）
get_portfolio_value	保有銘柄のリスト（スキームコードと口数）の現在価値を取得します
clear_cache	キャッシュされた AMFI データを削除し、次回の呼び出しで最新の NAV を取得します

投資信託の分析

ツール	機能
calculate_sip_returns	ファンドの実際の NAV 履歴を使って毎月の SIP をシミュレーションします。投資額、口数、評価額、絶対リターン、XIRR を算出します
compare_funds	1～5つのファンドについて、1年・3年・5年のリターン、ボラティリティ、最大ドローダウン、シャープレシオを並べて比較します
get_rolling_returns	ローリングリターンの分布（最小値、最大値、平均値、中央値、プラスまたは指定したしきい値を上回る頻度）を取得します

株式と市場データ（NSE/BSE、Yahoo Finance 経由。非公式で、可能な範囲での提供です）

ツール	機能
get_stock_quote	NSE/BSE 上場銘柄の最新価格、当日および52週間の値幅を取得します
get_index_quote	Nifty 50、Sensex、Bank Nifty、Nifty IT、India VIX の情報を取得します
get_stock_history	株式または指数の OHLCV 履歴を取得します

計算ツール

ツール	機能
calculate_xirr	日付付きの任意のキャッシュフローから XIRR を算出します
calculate_cagr	2つの値と日付範囲から CAGR を算出します
calculate_emi	ローンの EMI、総支払額、総利息を算出します
calculate_fd / calculate_rd	定期預金と積立預金の満期額を算出します
calculate_lumpsum_value	一括投資の将来価値を算出します
project_sip	想定リターンに基づいて SIP の将来価値を予測します。年ごとの積立額の増額も指定できます
calculate_swp	毎月の取り崩しを行った場合に、資産がどれくらい持続するかを算出します
plan_retirement	必要な資産額と、その額を築くための毎月の SIP を算出します
estimate_mf_tax	ファンド売却時のキャピタルゲイン税を推定します。12か月の区分を正確に判定するには、購入日と売却日を指定してください

日付は DD-MM-YYYY または YYYY-MM-DD で指定できます。

インストール

Python 3.10 以降が必要です。

pip install bahi-mcp                # mutual funds + calculators
pip install "bahi-mcp[stocks]"      # adds NSE/BSE stock and index data

または、uv を使ってインストールせずに実行できます。

uvx bahi-mcp
uvx --with yfinance bahi-mcp        # with stock data

MCP クライアントを設定する

Claude Desktop

claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "bahi-mcp": {
      "command": "uvx",
      "args": ["--with", "yfinance", "bahi-mcp"]
    }
  }
}

株式データが不要な場合は、"--with", "yfinance" を削除してください。Claude Desktop を再起動します。

Cursor およびその他のクライアント

{
  "mcpServers": {
    "bahi-mcp": {
      "command": "uvx",
      "args": ["--with", "yfinance", "bahi-mcp"]
    }
  }
}

Cursor の場合は、これを ~/.cursor/mcp.json に保存してください。株式データが不要な場合は、"--with", "yfinance" を削除してください。

データと正確性に関する注意事項

• 投資信託データは、mftool（3.4以降）を通じてAMFIから取得します。NAVは市場取引終了後、通常はISTの午後9時頃までに公開されます。mftoolはNAVを24時間キャッシュするため、最新データを確認するには、夕方の更新後にclear_cacheを使用してください。
• 株式データは、yfinanceを通じてYahoo Financeから取得します。非公式のデータであり、遅延したり、レート制限が適用されたり、予告なく変更されたりする可能性があります。取引の判断には使用しないでください。
• 税額の推定では、株式ファンドに関する設定済みのFY 2026-27の前提（STCG 20%、年間の残りの₹1.25 lakhの控除額を超えるLTCG 12.5%）を使用します。暦上の12か月による正確な分類には購入日と売却日を指定してください。概算の365日を基準とする場合は保有日数を指定してください。控除額は、会計年度内の適格な譲渡益全体で共有されます。債券ファンドは、2023年4月1日以降に購入した口数についてのみ、税率区分の税率でモデル化されます。追加税、損失の相殺、以前の指数連動ルールはモデル化されません。最新の法律を確認し、税務専門家に相談してください。
• 予測（project_sip、calculate_swp、plan_retirement）では、リターンが一定であると仮定します。実際の市場はそのようには動きません。

開発

git clone https://github.com/NayakwadiS/bahi-mcp
cd bahi-mcp
python -m venv .venv
source .venv/bin/activate        # Windows: .venv\Scripts\activate
pip install -e ".[dev,stocks]"
pytest
python -m bahi_mcp               # runs the server over stdio

src/bahi_mcp/の構成：

• analytics.py、fund_analytics.py、calculators.py：ネットワークアクセスのない純粋なPythonで、オフラインで完全にテスト済みです
• data.py：mftoolを通じたAMFIへのアクセス
• market.py：yfinanceを通じた株式および指数へのアクセス
• server.py：MCPツールの定義

ロードマップ

• ポートフォリオの重複とファンド間の相関
• ファクトシートおよびSEBI/RBIの通達を対象としたドキュメント検索
• キャッシュ機能を備えたホスト版

コントリビューション

Issueとプルリクエストを歓迎します。

ライセンス

MITです。LICENSEを参照してください。