Indian Stock Exchange

Name: Indian Stock Exchange
Author: prakharv-ops

本地服务

github.com/prakharv-ops金融数据02 周前更新

代码仓库

关于 Indian Stock Exchange

Indian Stock Exchange 是面向 NSE/BSE 股票、共同基金、IPO 和大宗商品研究的 MCP 服务。它提供只读市场工具、分析提示词与资源，并以精简数据支持比较和研究。

主要功能

0127 个只读市场工具
02股票概览与比较
03财务数据和分析师目标价
04市场异动、新闻与 IPO
05共同基金搜索和详情
06分析提示词与数据资源

适用场景

01比较不同股票的估值和表现
02查看公司财务与持股情况
03查询市场动态和 IPO 日程
04按类别和回报筛选共同基金

MCP 相关

向 MCP 客户端提供市场数据工具、五个分析提示词和三项资源。支持供桌面客户端使用的 stdio，以及无状态 Streamable HTTP 远程接入。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "prakharv-ops-indian-stock-exchange": {
      "command": "npx",
      "args": [
        "-y",
        "@prakharverma20082005/indian-stock-exchange-mcp"
      ],
      "env": {
        "ISE_API_KEY": "<ISE_API_KEY>"
      }
    }
  }
}

启动命令npx -y @prakharverma20082005/indian-stock-exchange-mcp

需要配置的环境变量

ISE_API_KEY密钥API key from https://indianapi.in/indian-stock-market

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@prakharverma20082005/indian-stock-exchange-mcp2.0.0stdio

工具

收录的工具列表 · 更新于 3 周前

参数	类型	必填	说明
limit	integer	否	要返回的最大条目数（1-25）
query	string	是	搜索文本，例如 'tata'

详细介绍

印度证券交易所 MCP 服务

一个 MCP 服务，让 Claude（以及任何 MCP 客户端）实时访问印度市场：NSE/BSE 股票、基本面、分析师目标价、IPO、共同基金和大宗商品。你可以询问：

“比较 TCS、Infosys 和 Wipro 的估值、利润率和动能。”
“为 Reliance 撰写一份研究报告：涵盖财务状况、持股变动、分析师目标价和近期公告。”
“今天市场有哪些动向？本周有 IPO 开始认购吗？”
“按 3 年回报率筛选最佳中型共同基金，并比较排名前三的基金。”

数据来自 Indian Stock Market API。

演示：compare-stocks 工具并排返回 TCS、Infosys 和 Wipro 的信息

compare-stocks 工具的实际输出。运行 node scripts/capture-demo.mjs && scripts/render-demo.sh 可重新生成。

功能

27 个工具，全部为只读并有相应标注，提供精简、适合分析的输出，而非原始 API 数据
一次调用获取股票快照：价格、区间、估值、盈利能力、增长、杠杆、回报、移动平均线趋势、分析师共识和同业公司
基本面：多年损益表、资产负债表、现金流、比率、持股结构、分析师预估和目标价
市场：涨幅榜/跌幅榜、交易最活跃股票、价格异动股票、52 周新高/新低、新闻、IPO 日历、大宗商品期货
共同基金：搜索、按类别和回报率浏览、查看完整基金详情
5 个提示词（analyze-stock、compare-stocks、market-briefing、dividend-and-events、mutual-fund-picks）和 3 个资源（新闻、IPO 日历、ise://stock/{name}）
可靠的客户端：请求超时、遇到 429/5xx 时采用退避策略重试、内存 TTL 缓存、进行中的请求去重、清晰的错误消息，并且绝不会在输出中暴露 API 密钥
支持桌面客户端的 stdio 传输方式，以及适用于远程使用的无状态 Streamable HTTP

工具

领域	工具	功能
股票	`search-stocks`	根据名称查找 NSE/BSE 代码和 ISIN
	`get-stock-snapshot`	股票概要（建议从这里开始）
	`get-stock-price`	最新价格、当日区间、52 周区间
	`get-stock-details`	简介、关键指标、持股情况、公司行动，以及按板块分类的新闻
	`get-stock-history`	查询 1 个月至最长时间范围内的价格、P/E、P/B、利润率或 EV 历史数据
	`compare-stocks`	并排比较 2 至 5 只股票
	`get-peers`	同业公司及其估值和回报
	`get-stock-recommendations`	分析师评级明细和趋势
基本面	`get-financial-statements`	季度/年度业绩、资产负债表、现金流、比率
	`get-shareholding-pattern`	查看发起人/FII/DII/公众持股情况随时间的变化
	`get-analyst-estimates`	共识预测或实际数据（EPS、销售额、净收入、EBITDA、ROE 等）
	`get-price-target`	目标价的均值/最高值/最低值及共识建议
	`get-corporate-actions`	股息、红股、拆股、供股、董事会会议
	`get-announcements`	近期交易所公告及链接
市场	`get-market-overview`	一次调用获取市场异动、交易活动、价格异动和头条新闻
	`get-top-gainers` / `get-top-losers`	今日涨幅最大/跌幅最大的股票
	`get-most-active`	成交量最大的股票（NSE 或 BSE）
	`get-price-shockers`	价格出现异常波动的股票（NSE 或 BSE）
	`get-52-week-highs-lows`	处于 52 周极值的股票
	`get-news` / `get-market-news`	最新头条及摘要
	`get-ipos`	即将推出、正在认购、已结束和已上市的 IPO
	`get-commodities`	含未平仓合约信号的 MCX 期货
共同基金	`search-mutual-funds`	按名称查找基金
	`get-mutual-fund-details`	NAV、回报、风险、费用率、持仓
	`list-mutual-funds`	浏览共同基金，并按类别和回报周期排名

设置

需要 Node.js 20+ 和来自 indianapi.in 的 API 密钥。

git clone <this repo> && cd Indian-Stock-Exchange-MCP
cp .env.example .env        # then set ISE_API_KEY
npm install
npm run build

密钥从环境变量 ISE_API_KEY、.env 或 src/.env 中读取。切勿提交密钥；这三个文件都已加入 git 忽略列表。

Claude Desktop

设置 > 开发者 > 编辑配置：

{
  "mcpServers": {
    "indian-stock-exchange": {
      "command": "node",
      "args": ["/absolute/path/to/Indian-Stock-Exchange-MCP/build/index.js"],
      "env": { "ISE_API_KEY": "your_api_key_here" }
    }
  }
}

重启 Claude Desktop。

Claude Code

claude mcp add indian-stock-exchange --env ISE_API_KEY=your_api_key_here -- node /absolute/path/to/build/index.js

HTTP 模式

npm run start:http          # http://127.0.0.1:3000/mcp  (health check: /health)

无状态 Streamable HTTP，默认绑定到 localhost（可通过 HOST 和 PORT 覆盖）。它不提供身份验证，因此在将其暴露到本机之外之前，请将其置于带身份验证的反向代理之后。

开发

npm test         # build + unit tests (mocked HTTP, no key needed)
npm run smoke    # calls every tool against the live API (needs ISE_API_KEY)

src/
  index.ts          entry point: stdio or --http
  server.ts         builds the McpServer and registers everything
  client.ts         API client: auth, timeout, retry, cache
  tools/            stocks, fundamentals, market, funds
  prompts.ts        reusable analysis prompts
  resources.ts      news, IPO and per-stock resources

说明

金额以 INR 为单位；市值以 crore 为单位。
get-top-gainers/get-top-losers 来自 API 的热门列表，该列表包含在 BSE 上市的股票；如需查询 NSE，请使用 get-price-shockers 并设置 exchange: NSE。
默认情况下，响应会缓存 60 秒（ISE_CACHE_TTL_MS）；历史数据和基本面数据的缓存时间更长。
此服务提供信息，不构成投资建议。