india-stock-mcp

india-stock-mcp

インド株式市場データ向けの MCP サーバーです。NSE/BSE の株価、過去の価格、ファンダメンタルズ、投資信託の NAV、指数、企業アクション、F&O オプションチェーン、IPO、ポートフォリオ分析を提供します。

あらゆる MCP クライアントで利用できます：Claude Desktop、Claude Code、Cursor など。API キー不要、認証不要、すべて無料のデータソースです。

ツール（16）

ツール	機能
get_quote	NSE/BSE の株式と指数のリアルタイム価格、出来高、52 週間の値幅
get_historical	OHLCV 履歴 — 日次／週次／月次
search_symbol	企業名から株式シンボルを検索
get_fundamentals	P/E、EPS、ROE、利益率、負債、成長率
compare_stocks	2～5 銘柄を並べて比較
get_index	任意の NSE 指数（P/E、P/B、値上がり／値下がり銘柄数）＋ SENSEX
get_market_status	市場は開いていますか？セグメントごとの取引時間情報
get_gainers_losers	変動率順に並べた NIFTY 50 の値上がり／値下がり銘柄上位
get_corporate_actions	株式ごと、または市場全体の配当、株式分割、ボーナス
get_options_chain	ATM 付近の F&O チェーン：LTP、OI、OI 変化、IV、出来高
get_ipo_list	現在／今後／最近上場した IPO
search_funds	インドの投資信託スキーム 15,000 件以上を検索
get_fund_nav	スキームの NAV 履歴
get_fund_details	ファンド運用会社、カテゴリー、現在の NAV
compare_funds	2～4 ファンド：任意の期間における NAV ＋リターン率
portfolio_summary	保有銘柄 → 現在価値、損益、配分の内訳

要件

• Node.js 22 以降

セットアップ

npm 経由（推奨）

クローン不要、ビルド不要です：

Claude Code

claude mcp add india-stock -- npx -y india-stock-mcp

Claude Desktop — claude_desktop_config.json に追加します（macOS：~/Library/Application Support/Claude/、Windows：%APPDATA%\Claude\）。

{
  "mcpServers": {
    "india-stock": {
      "command": "npx",
      "args": ["-y", "india-stock-mcp"]
    }
  }
}

ソースから

git clone https://github.com/Akhilgovind02/india-stock-mcp.git
cd india-stock-mcp
npm install
npm run build
claude mcp add india-stock -- node /absolute/path/to/india-stock-mcp/dist/index.js

Claude Desktop を完全に再起動してから、新しいチャットでツールアイコンを探してください。

プロンプトの例

• 「RELIANCE の株価と、52 週間高値からどれくらい離れているかを教えて」
• 「HDFC Bank、ICICI Bank、SBI のファンダメンタルズを比較して」
• 「本日の NIFTY 50 値上がり銘柄上位 5 件」
• 「NIFTY のオプションチェーンで、建玉が最も多いのはどこ？」
• 「Parag Parikh Flexi Cap と Quant Small Cap の 3 年間の成績を比較して」
• 「ポートフォリオを分析して：RELIANCE を 1200 で 10 株、TCS を 3000 で 5 株」

開発

npm run dev                      # run from TypeScript directly
npx tsx scripts/test-mcp.ts      # end-to-end test of all 16 tools (live data)
npx tsx scripts/test-edge.ts     # 24 edge-case assertions
npm run build                    # compile to dist/

テスト出力例

npx tsx scripts/test-mcp.ts の実際の出力（ライブデータ、取引時間中、2026 年 6 月 — 一部省略）：

TOOLS: get_quote, get_historical, search_symbol, search_funds, get_fund_nav,
get_fundamentals, compare_stocks, get_index, get_market_status, get_gainers_losers,
get_corporate_actions, get_options_chain, get_ipo_list, get_fund_details,
compare_funds, portfolio_summary

PASS get_quote: {"source":"Yahoo Finance","symbol":"RELIANCE.NS","name":"RELIANCE
  INDUSTRIES LTD","price":1266,"changePct":0.23,"volume":6107188,...}
PASS get_index: {"source":"NSE","index":"NIFTY BANK","last":55915,"percentChange":1.34,
  "yearHigh":61764.85,"pe":...}
PASS get_market_status: [{"market":"Capital Market","marketStatus":"Open",...}]
PASS get_gainers_losers: {"type":"gainers","universe":"NIFTY 50","data":[{"symbol":
  "SHRIRAMFIN","changePct":3.17,...}]}
PASS get_corporate_actions: {"symbol":"RELIANCE","actions":[{"subject":"Dividend -
  Rs 5.5 Per Share","exDate":"14-Aug-2025",...}]}
PASS get_options_chain: {"symbol":"NIFTY","underlyingValue":23331,"atmStrike":23350,
  "availableExpiries":["16-Jun-2026",...],"data":[{"strikePrice":...,"CE":{"lastPrice":
  130.95,"openInterest":144769,"impliedVolatility":12.26},...}]}
PASS get_ipo_list: {"type":"current","ipos":[{"companyName":"Utkal Speciality
  Industries India Limited","status":"Active",...}]}
PASS compare_funds: {"comparison":[{"name":"Parag Parikh Flexi Cap Fund - Direct
  Plan - Growth","latestNAV":88.484,...}]}
PASS portfolio_summary: {"summary":{"totalInvested":41000,"totalCurrentValue":38663,
  "totalPnL":-2337,"totalPnLPct":-5.7,...}}

... all 16 tools PASS

データソース

ソース	用途	備考
Yahoo Finance（yahoo-finance2）	株価、履歴、ファンダメンタルズ、検索	主なデータソースです。数分遅れる場合があります
NSE India（nse-bse-api）	市場状況、指数、企業アクション、IPO、オプションチェーン	一部の NSE エンドポイント（株価、オートコンプリート）は現在一般公開されていません。サーバーは自動的に Yahoo にフォールバックします
mfapi.in	投資信託の NAV と検索	無料ですが、ときどき不安定です。リクエストは 1 回再試行されます
mfdata.in	ファンド評価／経費率	接続できないことが多いため、mfapi.in にフォールバックします

既知の制限事項

• get_gainers_losers は組み込みの NIFTY 50 構成銘柄リスト（2026 年 6 月確認済み）を使って順位付けします。NSE は年に約 2 回指数を再構成するため、その際は src/index.ts の NIFTY50_SYMBOLS を更新してください。
• 株価は遅延する場合があります（Yahoo の無料フィード）。リアルタイム取引の判断には適していません。
• NSE は過度な利用に対してレート制限を設けたり、アクセスをブロックしたりする場合があります。

免責事項

データは無料の公開ソースから取得しており、遅延、不完全、または誤っている可能性があります。これは金融アドバイスではなく、ライセンスを持つブローカーやアドバイザーに代わるものでもありません。取引や投資を行う前に、ご自身で調査してください。

ライセンス

MIT