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 許可證。