nse-bse-mcp

🚀 NSE-BSE MCP Server

NSE-BSE MCP Server 是一个用于印度国家证券交易所（NSE）和孟买证券交易所（BSE）股票市场 API 的模型上下文协议（MCP）服务器，采用可流式传输的 HTTP 传输方式。借助该服务器，你可以获取印度股票市场的实时数据，并让大语言模型（LLMs）为你进行分析。

🚀 快速开始

你可以使用以下命令快速启动：

npx nse-bse-mcp

或者从源代码运行：

# 需要安装 Bun: https://bun.sh
bun install
bun run build
bun start

🐳 Docker 部署

cd docker
docker-compose up -d

服务器将在 http://localhost:3000/mcp 上可用。

💻 MCP 客户端设置（Gemini CLI、Claude Desktop、ChatGPT）

{
  "mcpServers": {
    "nse-bse-mcp": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "http://localhost:3000/mcp", "--allow-http"]
    }
  }
}

✨ 主要特性

• 66 种工具（44 种 NSE 工具 + 20 种 BSE 工具 + 2 种文档工具）
• 智能响应限制：对于大型响应，返回元数据，让大语言模型决定要获取的内容
• 文档下载器：下载并提取首次公开募股（IPO）招股说明书、报告、通告等文档
• 可流式传输的 HTTP 传输方式（无状态）
• 支持跨域资源共享（CORS），方便在浏览器中使用
• 健康检查端点，便于监控服务器状态
• 适合生产环境使用

🛠️ 工具列表（共 66 种）

NSE 工具（44 种）

市场数据（6 种工具）

• nse_get_market_status：获取当前市场状态和交易时间
• nse_equity_quote：获取实时股票报价
• nse_get_quote：根据细分市场（股票、中小企业板、共同基金、债券）获取报价
• nse_lookup_symbol：按名称或部分匹配搜索股票代码
• nse_get_gainers：获取市场数据中的涨幅居前股票
• nse_get_losers：获取市场数据中的跌幅居前股票

历史数据（4 种工具）

• nse_equity_historical：获取指定日期范围内的股票历史数据
• nse_index_historical：获取历史指数数据
• nse_fno_historical：获取历史期货和期权（F&O）数据
• nse_vix_historical：获取历史 VIX（波动率指数）数据

期权与衍生品（6 种工具）

• nse_option_chain：获取股票的完整期权链
• nse_filtered_option_chain：根据执行价格范围过滤期权链
• nse_compile_option_chain：获取特定到期日期的期权链
• nse_calculate_max_pain：计算期权的最大痛点
• nse_fno_lots：获取所有股票的 F&O 合约大小
• nse_futures_expiry：获取期货到期日期

公司信息（5 种工具）

• nse_corporate_actions：获取公司行动信息（股息、拆股、红利等）
• nse_corporate_announcements：获取公司公告
• nse_board_meetings：获取董事会会议信息
• nse_annual_reports：获取公司年度报告
• nse_circulars：获取 NSE 通告

首次公开募股（IPO）工具（4 种工具）

• nse_current_ipos：获取当前/正在进行的 IPO 信息
• nse_upcoming_ipos：获取即将进行的 IPO 信息
• nse_past_ipos：获取指定日期范围内的过往 IPO 信息
• nse_ipo_details：获取详细的 IPO 信息

市场活动（3 种工具）

• nse_block_deals：获取大宗交易数据
• nse_bulk_deals：获取批量交易数据
• nse_holidays：获取市场假期（交易/清算）信息

列表与元数据（6 种工具）

• nse_list_indices：获取所有 NSE 指数列表
• nse_list_stocks_by_index：获取特定指数中的股票列表
• nse_list_etf：获取所有交易型开放式指数基金（ETF）列表
• nse_list_sme：获取所有中小企业板股票列表
• nse_list_sgb：获取所有主权黄金债券列表
• nse_equity_meta_info：获取股票代码的元信息

下载工具（4 种工具）

• nse_download_equity_bhavcopy：下载股票交易数据报告
• nse_download_delivery_bhavcopy：下载交割数据报告
• nse_download_indices_bhavcopy：下载指数交易数据报告
• nse_download_fno_bhavcopy：下载 F&O 交易数据报告

BSE 工具（20 种）

市场数据（6 种工具）

• bse_quote：根据股票代码获取实时股票报价
• bse_quote_weekly_hl：获取 52 周和月度的最高/最低价格数据
• bse_gainers：根据板块/指数过滤获取涨幅居前的股票
• bse_losers：根据板块/指数过滤获取跌幅居前的股票
• bse_advance_decline：获取所有指数的涨跌值
• bse_near_52week：获取接近 52 周最高/最低价格的股票

历史数据（2 种工具）

• bse_index_historical：获取历史指数数据（每日/每周/每月）
• bse_all_indices_by_date：获取指定日期的所有指数数据

公司信息（3 种工具）

• bse_corporate_actions：通过高级过滤获取公司行动信息
• bse_announcements：按类别获取公司公告
• bse_result_calendar：获取公司业绩公布日历

搜索与查询（4 种工具）

• bse_lookup_symbol：按名称、代码、国际证券识别编码（ISIN）或股票代码搜索
• bse_get_scrip_name：根据股票代码获取股票名称
• bse_get_scrip_code：根据股票名称获取股票代码
• bse_list_securities：根据行业/板块过滤列出证券

报告下载（2 种工具）

• bse_download_bhavcopy：下载每日交易数据报告
• bse_download_delivery：下载每日交割报告

元数据（2 种工具）

• bse_fetch_index_names：获取所有 BSE 指数列表
• bse_fetch_index_metadata：获取指数报告的元信息

文档工具（2 种）

文档处理（2 种工具）

• download_document：下载并提取文档（PDF、文本、压缩文件等）
• read_document_pages：从缓存或新文档中读取特定页面

所有工具都支持通过 max_items 和 fields 参数进行 智能响应限制，以便高效处理大型数据集。

📄 许可证

本项目采用 MIT 许可证。