Tapetide - Indian Stock Market MCP

印度股市 MCP 服务 — 为 Claude、ChatGPT 和 Cursor 提供 NSE 与 BSE 数据

面向 NSE 和 BSE 的印度股市 MCP 服务：提供 55 个工具，可通过 Claude、ChatGPT、Cursor、VS Code、Codex、Gemini CLI 和任何 MCP 客户端搜索、筛选和分析全部 8,200 多只上市股票。

文档 • 快速开始 • 客户端配置指南 • 55 个工具 • 提示词示例 • npm • PyPI

---

Tapetide 是一款印度股市 MCP 服务，为 AI 助手提供所有 NSE 和 BSE 上市公司的实时结构化数据，涵盖 Nifty 50 和 Sensex 龙头股以及 SME 股票。将它连接到 Claude、ChatGPT、Cursor、VS Code、Codex 或 Gemini CLI，即可用日常语言查询股价、季度财务数据、包含 326 项指标的股票筛选器、技术指标、FII/DII 资金流、期权链和 IV、公司申报文件、IPO、大宗交易以及投资组合盈亏。

一行安装命令（适用于 Claude Code，需使用从 tapetide.com/settings/tokens 获取的免费令牌）：

claude mcp add tapetide -e TAPETIDE_TOKEN=your_token_here -- npx -y tapetide-mcp

也可以完全跳过安装，在 claude.ai、ChatGPT、Grok 或任何支持远程 MCP 的客户端中添加远程服务 URL https://mcp.tapetide.com/mcp。使用 Google 账号登录即可。

55 个工具 · 8,200 多只 NSE/BSE 股票 · 远程（OAuth）或本地（npx / uvx） · 免费套餐 · 16 个客户端的配置指南

兼容客户端

为所有主流 MCP 客户端提供分步配置指南：

聊天应用	代码编辑器和 IDE	终端 Agent
Claude.ai	Cursor	Claude Code
ChatGPT	VS Code（GitHub Copilot）	Codex CLI
Claude Desktop	Windsurf	Gemini CLI
Grok	Kiro	OpenCode
	Zed	Command Code
	Cline
	Antigravity

任何其他支持 Model Context Protocol 的客户端也能使用，既可通过远程 HTTP，也可通过本地 stdio。

快速开始

选项 1：远程 MCP（无需安装 — claude.ai、chatgpt.com、Grok、Gemini）

直接在 AI 聊天应用中添加此 URL：

https://mcp.tapetide.com/mcp

通过 Google OAuth 自动完成身份验证。无需令牌。

选项 2：使用令牌的远程 MCP（Claude Code、VS Code、Kiro、Zed）

适用于支持通过 URL 配置 MCP 服务并使用自定义标头的代码编辑器：

1. 在 tapetide.com/settings/tokens 获取免费令牌
2. 添加到 MCP 配置中：

{
  "mcpServers": {
    "tapetide": {
      "type": "url",
      "url": "https://mcp.tapetide.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN_HERE"
      }
    }
  }
}

选项 3：通过 npm 使用本地 MCP（Claude Code、Codex、Cursor、Windsurf、VS Code、Gemini CLI、Kiro、OpenCode）

适用于基于 stdio 的 MCP 客户端。无需克隆或构建 — 通过 npx 运行：

1. 在 tapetide.com/settings/tokens 获取免费令牌
2. 添加到 MCP 配置中：

{
  "mcpServers": {
    "tapetide": {
      "command": "npx",
      "args": ["-y", "tapetide-mcp"],
      "env": {
        "TAPETIDE_TOKEN": "your_token_here"
      }
    }
  }
}

本地选项需要 Node.js 18+。运行 node --version 进行检查。

Gemini CLI 扩展

gemini extensions install https://github.com/Tapetide-hq/nse-bse-indian-stock-market-data-mcp

安装时，系统会提示你输入 Tapetide 令牌。

安装为 Claude Code 插件

此仓库也是一个单插件 Claude Code 市场。在 Claude Code 中运行以下两条命令：

/plugin marketplace add Tapetide-hq/nse-bse-indian-stock-market-data-mcp
/plugin install tapetide-indian-stock-market@tapetide

Claude Code 2.1.275 或更高版本中，只需一行即可完成这两项操作：

/plugin install tapetide-indian-stock-market --marketplace Tapetide-hq/nse-bse-indian-stock-market-data-mcp

该插件连接到远程服务 https://mcp.tapetide.com/mcp，无需在本地安装任何内容。运行 /mcp 并选择 tapetide，首次使用时通过 Google 登录。

更希望使用带个人令牌的本地 stdio 服务？跳过插件，直接添加 npm 包（获取免费令牌）：

claude mcp add tapetide -e TAPETIDE_TOKEN=your_token_here -- npx -y tapetide-mcp

选项 4：通过 Python 使用本地 MCP（uvx / pip）

同一桥接程序，打包为适用于 Python 3.10+ 的版本 — tapetide-mcp on PyPI（源代码）：

{
  "mcpServers": {
    "tapetide": {
      "command": "uvx",
      "args": ["tapetide-mcp"],
      "env": {
        "TAPETIDE_TOKEN": "your_token_here"
      }
    }
  }
}

工作原理

┌─────────────────┐     stdio (JSON-RPC)     ┌──────────────────┐     HTTPS      ┌─────────────────────┐
│  AI Assistant   │ ◄──────────────────────► │  tapetide-mcp    │ ◄────────────► │  mcp.tapetide.com   │
│  (Claude, etc.) │                           │  (npm package)   │                │  (Cloudflare Worker) │
└─────────────────┘                           └──────────────────┘                └─────────────────────┘

npm 包是一个轻量级 stdio 桥接程序，运行时没有任何依赖。它会：

• 从 stdin 读取 JSON-RPC，将其转发到远程 Tapetide MCP 服务，并将响应写入 stdout
• 自动检测帧格式：Content-Length（VS Code、Claude Desktop）或以换行符分隔的 JSON（Kiro、Claude Code）
• 将你的刷新令牌换成有效期为 1 小时的 HMAC 访问令牌，并在令牌过期前自动刷新
• 处理来自远程服务的 SSE 响应
• 通过 User-Agent 向远程服务标识你的 MCP 客户端，并回传协商后的协议版本
• 当服务对调用进行速率限制时，在 stderr 上发出警告并说明重试延迟
• 在每个后续请求中重放服务在 initialize 阶段生成的 Mcp-Session-Id，使远程服务能够关联同一会话中的调用
• 原样转发 MCP Apps 流量 — resources/list、resources/read 以及 get_price_history、market_heatmap 和 screen_stocks 上的 _meta.ui 提示都会按服务发送的内容原样到达你的客户端

全部 55 个工具及其逻辑都在远程服务上运行 — npm 包仅负责传输。 由于它会逐字转发 JSON-RPC，远程服务上发布的工具无需升级此包即可立即使用。

身份验证

方法	工作原理	适用场景
Google OAuth	浏览器登录，自动刷新令牌	AI 聊天应用（Claude.ai、ChatGPT、Grok、Gemini）
个人令牌（远程）	Authorization: Bearer tpt_rt_... 标头	使用基于 URL 的 MCP 的代码编辑器（VS Code、Kiro、Zed）
个人令牌（本地）	通过 npx 设置 TAPETIDE_TOKEN 环境变量	stdio MCP 客户端（Cursor、Windsurf、Claude Desktop、Codex）

在 tapetide.com/settings/tokens 生成免费的个人令牌。远程和本地 MCP 均可使用。

工具

提示：请让助手先调用 read_me。它会返回完整的会话内指南，包括按类别划分的所有 工具、使用模式，以及服务要求客户端遵循的规则。

三个工具为支持 MCP Apps 的宿主环境（Claude、Claude Desktop、VS Code Copilot）提供交互式视图：get_price_history 会呈现价格和成交量图表， market_heatmap 会呈现指数树状图，screen_stocks 会呈现可排序的结果表格。仅支持文本的宿主环境 也会获取相同的 JSON 结果，不会缺少任何内容。

🔍 发现与筛选（5 个工具）

工具	描述
search_stocks	根据公司名称、股票代码、BSE 代码或 ISIN 查找公司代码，包括品牌名称和更名后的别名（Zomato → ETERNAL）。可按行业或产业筛选。
screen_stocks	基于 326 项比率进行基本面筛选，包括 PE、ROCE、销售额增长、负债/权益比和 Piotroski 评分。支持使用 AND/OR 逻辑和跨字段比较的自然语言查询语法。
screen_stocks_technical	实时技术面筛选工具，支持 RSI、MACD、SMA/EMA 交叉、布林带、ADX、成交量和动量。支持 crosses_above/crosses_below。
get_screener_ratios	搜索或浏览完整的 326 项比率目录，以获取查询所需的准确比率名称。
get_trending_stocks	获取今日 Nifty 500 中涨幅最大、跌幅最大和交易最活跃的股票。

📊 公司分析（9 个工具）

工具	描述
get_company_profile	全面概览，包括行业、业务摘要、优缺点、基本面、增长指标和当前报价。可在同一次调用中选择添加技术指标（20 多项）、分析师评级和同行公司信息。
get_stock_quote	实时价格，包括 LTP、涨跌幅 %、成交量、市值、PE、PB 和 52 周高/低价。
get_batch_quotes	单次调用最多获取 20 只股票的报价。
get_price_history	获取日线或周线 OHLCV 数据及交割比例 %。单次调用最多获取 2,000 个交易日的数据，还可分页获取更早的数据。
get_financials	季度和年度损益表、资产负债表、现金流量表及比率。每个期间都会标注实际发布时间，帮助回测避免前视偏差。
get_shareholding	按季度查看发起人、FII、DII 和公众持股情况。
get_forecasts	查看分析师对 EPS、收入、EBITDA、净利润、ROA 和 ROE 的预估及实际值，以发现业绩意外。
get_stock_events	带有情绪标签的新闻、公司行动（股息、拆股、红股、AGM）及文件（业绩、演示文稿、业绩说明会文字稿、年度报告）。
get_stock_ownership	股息历史及收益率，以及持有该股票的共同基金计划和其持股占 AUM 的比例。

🏛️ 全市场数据（11 个工具）

工具	说明
get_market_pulse	每日市场概览快照：一次调用即可查看 FII/DII 净流量、Nifty 50 估值和 India VIX。
get_fii_dii_detail	30 天的每日现金市场资金流、F&O 参与者多头／空头 OI、每周／每月／每年汇总、买入／卖出连涨记录及累计净流量。
get_fii_dii_flows	get_fii_dii_detail 的别名。
get_fpi_sectors	按行业划分的 FPI 投资：AUM 占比、双周变化及 1 年累计流量。
get_market_news	涵盖多个类别的全市场新闻，包含情绪和相关标的。
get_market_data	通过 dataset 分发七种每日数据：deals、fno_ban、deliveries、ipo、mtf、slbm、signals。
market_heatmap	显示某指数的所有成分股及其市值、PE、PB、1d 至 5y 收益率、成交量和行业；共涵盖 16 个指数。
market_valuations	随时间变化的指数 PE、PB 和股息率，最长可追溯 20 年。
get_india_vix	India VIX 恐慌指标：最新水平、每日变化和近期历史数据。
get_index_performance	按已结束的周或月收益率对约 140 个 NSE 指数排名。可按行业、宽基、主题或策略类别筛选，适用于回答“上个月哪个行业领涨”。
get_index_history	单个指数的 OHLC 水平序列，以及 PE/PB／股息率。相当于指数版的 get_price_history。

🎲 衍生品与风险（5 个工具）

工具	说明
get_option_chain	按行权价列出指数期权链，包含 IV、完整 Greeks、买价／卖价、未平仓合约、最大痛点和 PCR。涵盖 NIFTY、BANKNIFTY、FINNIFTY、MIDCPNIFTY，提供带时间戳的日终快照。
get_option_iv_history	约 556 种标的的逐交易时段 ATM IV、IV 排名、IV 百分位、已实现波动率、PCR、最大痛点和 25-delta 偏斜，也包含个股。
get_options_analytics	最新的逐到期日汇总数据：ATM IV、IV 排名／百分位、已实现波动率、按 OI 和成交量计算的 PCR、最大痛点、偏斜及看涨／看跌 OI。
get_promoter_pledge	按季度列出的发起人股份质押比例及质押／解除质押事件，可用于标准的治理风险排查。
get_credit_ratings	按评级机构列出信用评级行动，包含评级、行动和随时间变化的展望。

🔬 研究与评分（4 个工具）

工具	说明
get_stock_deals	按个股列出大宗交易、大额交易、内幕交易和重大收购（SAST）披露，包含交易对手方、方向、数量和金额。
get_tapetide_score	某只股票的确定性 0-100 Tapetide Score，包含六个支柱的子评分、等级、百分位、数据置信度，以及任何治理上限或风险标记。
screen_tapetide_scores	按等级、规模类别、行业、评分区间和置信度对评分范围排名并筛选，支持游标分页。
get_earnings_call_summary	对近期财报电话会议文字稿和投资者演示文稿进行结构化整理，涵盖要点、风险、指引和核心指标。

📄 文件文本（3 个工具）

将解析后的文件作为文本读取——直接阅读年报或文字稿，而不只是摘要。

工具	说明
list_company_documents	公司已解析文件的索引，包括财报电话会议文字稿、年报、投资者演示文稿、IPO 文件；列出 doc_id、期间、页数、各文件的可用内容，以及 PDF 和完整 Markdown 的链接。请先调用此工具。
get_document_summary	按 doc_id 获取某份文件的投资者摘要（或获取最新的某类 doc_type 文件）：摘要、要点、风险、管理层指引和关键指标。上限为 6k 个字符；truncated: true 表示摘要经过删节。
read_document	按 doc_id 和页码范围读取文件的 Markdown 文本，并提供 `` 标记以供引用。每次调用最多读取 12 页／24k 个字符；结果会列出返回的页码和可继续获取的 next_pages。

⏳ 时点与回测安全（5 个工具）

工具	描述
get_adjustment_factors	用于还原原始价格的拆股和送股调整时间线 — 以及完全没有可靠因子的配股和分拆事件。
get_observation_status	说明每个日历日价格存在或缺失的原因：有交易、周末、节假日、上市前、退市或无成交记录。缺失日期不等于零收益。
get_index_membership_asof	某只股票在指定日期是否属于某个指数？返回 present、uncertain、absent 或 out_of_coverage — 用于构建考虑幸存者偏差的股票池。
resolve_identifier_asof	将历史代码或 ISIN 映射到某日期持有该标识的公司，用于处理旧持仓文件和重复使用的股票代码。
get_identifiers_asof	反向查询 — 某家公司在特定时点使用的股票代码和 ISIN。

💼 投资组合（4 个工具）

需要连接 Tapetide 账户。

工具	描述
get_user_portfolio	持仓及实时价格、绝对值和百分比盈亏、投资价值、权重、行业和市值类别。
add_portfolio_stocks	单只或批量添加持仓，包括从券商 CSV 或截图解析的行（Zerodha、Groww、Angel One、Dhan、Upstox、5Paisa、ICICI Direct、Kotak、HDFC Sky、Motilal Oswal）。重复项按加权平均价格合并。
update_portfolio_stock	在加仓或部分卖出后更新数量和平均价格。
remove_portfolio_stocks	从投资组合中移除持仓。

👁️ 自选列表（3 个工具）

需要连接 Tapetide 账户。

工具	描述
get_watchlist	所有已关注股票及其行业和细分行业。
add_to_watchlist	关注一只或多只股票。可幂等调用。
remove_from_watchlist	取消关注一只或多只股票。

📖 指南与别名（6 个工具）

工具	描述
read_me	完整的会话内指南 — 按类别列出每个工具、SEBI 免责声明规则、投资组合优先行为以及并行调用模式。助手应首先调用它。
scan_movers	get_trending_stocks 的别名。
get_live_quote	get_stock_quote 的别名。
get_stock_news	get_stock_events 的别名，参数为 type: "news"。
get_corporate_actions	get_stock_events 的别名，参数为 type: "corporate_actions"。
run_preset_screen	重定向工具，会将预设筛选请求指向能够实际处理该请求的筛选工具。

已退役的工具名称

这些名称已被移除。调用其中一个名称会返回一条消息，指出其替代项，因此客户端可以在同一轮中恢复 — 但新的集成应直接使用替代项。

已退役	替代项
market_deals	get_market_data，参数为 dataset: "deals"
market_fno_ban	get_market_data，参数为 dataset: "fno_ban"
market_deliveries	get_market_data，参数为 dataset: "deliveries"
market_ipo	get_market_data，参数为 dataset: "ipo"
market_mtf	get_market_data，参数为 dataset: "mtf"
market_slbm	get_market_data，参数为 dataset: "slbm"
market_signals	get_market_data，参数为 dataset: "signals"
get_quant_signal	get_tapetide_score（测量指标不同，并非更名）
screen_by_quant_signal	screen_tapetide_scores（测量指标不同，并非更名）

示例提示词

股票研究

"Give me a complete analysis of Reliance Industries — financials, debt trend,
 analyst target price, and what mutual funds are holding it"

"Compare HDFC Bank and ICICI Bank — quarterly profit growth, ROE, shareholding
 changes, and analyst consensus"

"Pull the last 4 quarters of TCS financials — revenue growth, margin trend,
 and cash flow. How does it compare to Infosys?"

股票筛选

"Find mid-cap stocks where FII holding increased last quarter, ROE > 15%,
 and RSI below 40 — accumulation candidates"

"Screen for stocks with MACD bullish crossover, volume 2x average, and
 within 10% of 52-week high"

"Which small-caps have debt-to-equity below 0.5, operating margin above 20%,
 and PE below 15?"

机构资金流向

"FIIs have been selling for 5 days — show me daily numbers and which sectors
 they're pulling out of"

"Compare FII vs DII flows for the last month with Nifty 50 PE — are we near
 a historical bottom?"

"Show F&O participant-wise open interest — are FIIs net long or short in
 index futures?"

投资组合与自选列表

"Add these to my portfolio: 10 RELIANCE at ₹1350, 50 TCS at ₹3800,
 25 HDFCBANK at ₹1650"

"I bought 10 more RELIANCE at ₹1400 — update my portfolio and show
 my new average cost"

"Which of my holdings are technically weak? Show RSI and MACD for each"

"Watch TATAMOTORS, MARUTI, M&M — compare their PE ratios and quarterly
 sales growth"

衍生品与波动率

"Is RELIANCE implied volatility high right now? Show IV rank and percentile
 versus realised vol over the last year"

"Show the NIFTY option chain around ATM — open interest by strike, max pain,
 and the put-call ratio"

"Which sectors led the last 3 completed weeks? Rank the sectoral indices"

评分与风险筛选

"What's the Tapetide Score for TATASTEEL and why — break down the pillars"

"Show me Strong-band pharma stocks among large and mid caps"

"Any governance red flags on this stock? Check promoter pledge trend and
 recent credit rating actions"

回测安全

"Was IDEA in the Nifty 500 on 2019-03-31? I need point-in-time membership,
 not today's list"

"This stock shows a 60% single-day move in 2022 — was that a split or a real
 return? Check the adjustment factors"

每日市场简报

"Full market briefing — FII/DII flows, F&O ban stocks, bulk deals above
 50 crores, top delivery stocks, and breakout signals"

"Is the market overvalued? Show Nifty 50 PE vs 5-year and 10-year averages"

"Show the Nifty 50 heatmap — which sectors dragged the index today?"

数据覆盖范围

类别	包含内容
股票	NSE 和 BSE 所有上市公司（约 8,200 家，含 SME）
价格数据	最多 2,000 天的日线 OHLCV 数据 + 周线汇总 + 交割百分比
财务数据	季度和年度损益表、资产负债表、现金流量表、50 多项比率
筛选器	326 项基本面比率 + 实时技术指标 + 跨字段比较
技术指标	RSI、SMA、EMA、MACD、布林带、ADX、ATR、Supertrend、随机指标、CCI、枢轴点、8 种蜡烛图形态
机构数据	FII/DII 每日现金流、F&O 参与者 OI、按行业划分的 FPI 配置、买入/卖出连续记录
市场数据	大宗/大宗交易、F&O 禁入名单、IPO、交割百分比、MTF、SLBM、热力图、信号
指数	约 140 个 NSE 指数 — 含 PE/PB/DY 的点位历史，以及按行业、宽基、主题和策略类别划分的周度/月度回报排名
衍生品	含 IV 和完整 Greeks 的指数期权链、OI、最大痛点、PCR；约 556 个标的（含个股）的 IV 排名/百分位和已实现波动率历史；India VIX
分析师	买入/持有/卖出共识 + EPS/营收/EBITDA/ROE 预测及实际值与估算值对比
所有权	持股模式（季度）、股息历史、共同基金计划级持仓
大额交易	大宗交易、大宗交易、内部人士（指定人员）交易及 SAST 披露，含交易对手方和金额
治理与风险	发起人股份质押历史及事件、按评级机构划分的信用评级行动及展望
评分	Tapetide Score — 确定性 0–100 评分，含六项支柱子分、等级、百分位、数据置信度和治理上限
时点数据	拆股/送股调整系数、逐日观察状态、截至指定日期的指数成分、历史代码/ISIN 解析 — 用于避免幸存者偏差的回测
新闻与事件	带情绪标签的新闻、公司行动、文件（年度报告、业绩电话会文字稿）、业绩电话会和投资者演示文稿的 AI 摘要
文件文本	业绩电话会文字稿、年度报告、投资者演示文稿和 IPO 文件解析为带页码的 Markdown，并提供单份文件摘要及 PDF/Markdown 下载链接
投资组合	实时盈亏跟踪、行业细分、经纪商 CSV 导入（10 多家印度经纪商）

环境变量

变量	必需	默认值	说明
TAPETIDE_TOKEN	是（本地）	—	从 tapetide.com/settings/tokens 获取个人 API 令牌
TAPETIDE_MCP_URL	否	https://mcp.tapetide.com	覆盖远程服务 URL
TAPETIDE_DEBUG	否	0	设为 1 可将调试日志输出到 stderr

速率限制

限制按 Tapetide 账户计算，且三种访问方式（OAuth、远程令牌和此 npm 桥接）的限制相同 — 限制取决于你的套餐，而非传输方式。

范围	免费套餐	付费套餐
每日	50 次工具调用	按你的套餐执行，参见 tapetide.com/pricing
每个日历月	无月度上限	按你的套餐执行（企业版不限量）
突发调用	每分钟 60 次工具调用	每分钟 60 次工具调用

只有成功的工具调用会消耗配额。协议流量（initialize、tools/list）和因突发调用限制而被拒绝的调用均免费。每日和每月窗口按 IST 边界重置。

达到限制时，服务会返回包含 isError: true 的常规 JSON-RPC 结果，并说明生效的上限及重置时间，因此助手会转达该信息，而不是重试。响应会携带 X-RateLimit-Reset，拒绝请求时还会附带 Retry-After。数值配额本身不会通过标头公开 — 请在 tapetide.com/settings/tokens 查看当前用量。

故障排查

问题	解决方案
调用工具时出现 TAPETIDE_TOKEN is not set	桥接程序启动时无需令牌，因此可以列出工具，但调用工具需要令牌。请将其添加到 MCP 配置的 env 部分
Token refresh failed (401)	令牌已过期。请前往 tapetide.com/settings/tokens 生成新令牌
Rate limit exceeded	等待限流重置（错误信息中会显示），或前往 tapetide.com/settings/tokens 查看用量
服务无响应	确保已安装 Node.js 18+（node --version）
首次请求较慢	这是正常现象——启动时会进行预身份验证。后续请求会很快
网络错误	检查网络连接。桥接程序需要连接到 mcp.tapetide.com

设置 TAPETIDE_DEBUG=1，即可将详细日志输出到 stderr。

链接

• tapetide.com — Web 平台
• tapetide.com/mcp — MCP 文档和设置指南
• mcp.tapetide.com — 远程 MCP 端点
• npm: tapetide-mcp — npm 包
• PyPI: tapetide-mcp — Python 包（源码）
• @tapetide_hq — X（Twitter）
• GitHub — 源代码
• Glama — MCP 目录页面

参与贡献

欢迎提交问题和拉取请求。报告 Bug 时，请附上错误信息以及 MCP 客户端名称和版本。

许可证

MIT — 可免费使用、修改和分发。

---

_{由 Tapetide 打造 — 印度 AI 优先的股票研究平台}