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	市盈率、每股收益、净资产收益率、利润率、债务、增长率
compare_stocks	并排比较 2–5 只股票
get_index	任意 NSE 指数（市盈率、市净率、上涨／下跌家数）及 SENSEX
get_market_status	市场是否开市？各细分市场的交易时段信息
get_gainers_losers	按涨跌幅排名的 NIFTY 50 涨幅榜
get_corporate_actions	按股票或整个市场查询股息、拆股、红股
get_options_chain	ATM 附近的 F&O 期权链：最新成交价、未平仓合约量、未平仓合约量变化、隐含波动率、成交量
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 年的表现”
• “分析我的投资组合：10 股 RELIANCE，买入价 1200；5 股 TCS，买入价 3000”

开发

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 和搜索	免费，偶尔不稳定——请求会重试一次
mfdata.in	基金评级／费用比率	经常无法访问；会改用 mfapi.in

已知限制

• get_gainers_losers 根据内置的 NIFTY 50 成分股列表排名（已于 2026 年 6 月核实）。NSE 每年会调整指数成分约 2 次——发生调整时，请更新 src/index.ts 中的 NIFTY50_SYMBOLS。
• 报价可能延迟（Yahoo 免费数据源）；不适合用于实时交易决策。
• NSE 可能会限制请求频率或阻止大量使用。

免责声明

数据来自免费的公开来源，可能存在延迟、不完整或错误。本项目不构成财务建议，也不能替代持牌经纪商或顾问的服务。交易或投资前请自行研究。

许可证

MIT