Finstack Mcp

FinStack MCP

面向印度和全球市场的 95 个免费工具。可在 Claude、Cursor 和任何 MCP 客户端中使用。

面向印度股票、全球市场和原生支持 MCP 的 AI 工作流的开源市场情报工具。 只需提问，例如 Should I buy Reliance?，即可在一个工具集中获取辩论、情绪、聪明资金、风险、同行对比和排名。

pip install finstack-mcp

或者无需安装即可运行：

uvx finstack-mcp

可以向 Claude 提问：

"Give me a full stock brief on Reliance"
-> 6 AI agents debate: FII Desk + Algo Trader + Value Investor + Retail Pulse + Macro Analyst + Options Flow
-> Consensus: BUY/HOLD/SELL with reasoning

"Is someone accumulating HDFC Bank quietly?"
-> Checks OI buildup, block deals, promoter buying, volume spike simultaneously

"What's the social buzz on TCS before results?"
-> StockTwits + Reddit + Economic Times -> 67% bullish | Signal: HOLD

"Will Nifty go up tomorrow?"
-> RSI + FII flow + PCR + VIX + G-Sec + GIFT Nifty -> 63% probability up

"Should I take a NIFTY CE or PE today?"
-> Intraday F&O setup -> BUY_CE / BUY_PE / NO_TRADE with ATM strike zone, confidence, and approval-ready summary

"Give me the 8:15 AM F&O brief"
-> GIFT Nifty + VIX + NIFTY setup + BANKNIFTY setup -> ready-to-forward morning note

"Scan my portfolio for risk"
-> Sector concentration, pledged promoters, FII exposure, XIRR, diversification score

"Is this Telegram stock tip channel a scam?"
-> Accuracy %, avg return %, pump-and-dump probability scored

演示预览

股票简报实战

Agent 对战可视化

输出示例

发布资源

• 验证与准确性说明
• GitHub 发布文案与定位
• 发布检查清单

与众不同之处

• 优先为印度市场打造，而非在面向美国市场的封装工具中事后添加几个 NSE 股票代码
• 原生支持 MCP，可在 Claude、Cursor 和其他 Agent 工作流中使用，而不只是另一个仪表板
• 结合数据、评分、辩论和研究工作流，无需用户将 5 个付费工具拼凑在一起
• 包含竞争产品通常完全不提供的工具：股票辩论、自选列表排名、股票时间线、Telegram 跟踪器、GST 与股票关联分析，以及预算分析器

---

可替代的工具

工具	费用	finstack-mcp
Bloomberg Terminal	$31,980 / 年	免费
Bloomberg ESG + Credit	$24,000 / 年	免费
Sensibull（期权希腊值）	₹15,600 / 年	免费
Morningstar（共同基金资金流）	$17,500 / 年	免费
Zerodha 实时数据	₹6,000 / 年	通过 Angel One 免费
Screener.in Pro	₹4,999 / 年	免费
Trendlyne Pro	₹4,950 / 年	免费

---

安装并连接（2 分钟）

pip install finstack-mcp

Claude Desktop

添加到 claude_desktop_config.json：

macOS： ~/Library/Application Support/Claude/claude_desktop_config.json Windows： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "finstack": {
      "command": "python",
      "args": ["-m", "finstack.server"]
    }
  }
}

重启 Claude Desktop。完成。

Cursor / Windsurf / Cline

{
  "mcpServers": {
    "finstack": {
      "command": "python",
      "args": ["-m", "finstack.server"]
    }
  }
}

添加到 IDE 的 MCP 配置文件，然后重新加载。

uvx（无需安装）

{
  "mcpServers": {
    "finstack": {
      "command": "uvx",
      "args": ["finstack-mcp"]
    }
  }
}

适用于：Claude Desktop · Cursor · Windsurf · Cline · Continue.dev · Zed · Jan.ai · LibreChat · 任何 MCP 客户端

---

远程 MCP 发布路线图

如果你希望 finstack-mcp 不再局限于本地桌面配置，并通过连接器生态系统提供服务，请保留面向开发者的本地 python -m finstack.server 配置，并新增托管的远程 MCP 版本以供公开分发。

远程 HTTP 需要构建的内容

• 通过 HTTPS 上的公共 MCP 端点提供 FinStack，最好使用 Streamable HTTP 或 SSE。
• 向外部用户开放之前，先添加 OAuth。
• 保持工具描述范围明确、清晰且安全。
• 添加速率限制、监控和醒目的支持联系方式。
• 在正式提交之前发布隐私政策和服务条款。

ChatGPT / OpenAI 路径

• 托管可通过 HTTPS 访问的远程 MCP 服务。
• 先在 ChatGPT 中将其作为自定义连接器或自定义应用进行测试。
• 如果希望更广泛地兼容 OpenAI 连接器工作流，请添加 search 和 fetch 等便于连接器使用的读取工具。
• 将 get_stock_brief、get_stock_debate、get_social_sentiment 和 analyze_portfolio 等 FinStack 专属工具作为其上的领域工具保留。

Claude / Anthropic 路径

• 首先确保服务器可作为自定义连接器正常工作。
• 然后做好接受目录审核的准备，不要以为会立即上架。
• Anthropic 会在将第三方 MCP 服务纳入目录前，对其安全性、隐私和兼容性进行审核。
• 即使服务器在技术上有效，也不保证会被列入目录。

实用提交清单

• 公共 HTTPS MCP 端点
• OAuth 登录流程
• 稳定的服务器运行时间
• 安全的工具范围和描述
• 隐私政策
• 服务条款
• 支持邮箱或问题跟踪器
• 清晰的文档和示例提示词
• 不包含鼓励绕过模型安全策略的工具行为

推荐的产品拆分方式

• 本地 stdio MCP：最适合开发者和高级用户
• 托管的远程 MCP：最适合连接器和更广泛的分发
• 独立托管的 FinStack 网页 UI：最适合 Agent Battle 等高级视觉体验

这样可将 MCP 作为执行层，并将自有前端打造为高级体验。

---

10 个类别中的 95 个工具

印度市场（实时数据）

• NSE/BSE 实时报价、OHLCV 历史数据、市场状态
• Nifty 50、Bank Nifty、Sensex 指数
• FII/DII 机构资金流（每日及历史数据）
• 大宗交易和大宗协议交易、熔断扫描器、52 周高点/低点扫描器
• 共同基金 NAV、公司行动、财报日历、IPO 日历

AI 智能分析（finstack-mcp 独有）

• get_stock_brief — 6 个 AI Agent 就任意股票进行辩论 → 达成 BUY/HOLD/SELL 共识
• get_stock_debate — 通过 3 轮顺序式 Agent 辩论和反驳，形成涌现共识
• get_social_sentiment — StockTwits + Reddit + ET RSS → 情绪信号
• detect_unusual_activity — OI 累积 + 大宗交易 + 发起人变动 + 成交量激增
• get_nifty_outlook — 基于 6 个信号的概率模型，预测下一交易日方向
• get_fno_trade_setup — NIFTY / BANKNIFTY 期权建议：BUY_CE、BUY_PE 或 NO_TRADE，并提供 ATM 行权价指引
• predict_earnings — 季度业绩公布前预测超出/未达预期的概率
• get_fii_retail_divergence — 印度市场中置信度最高的信号
• get_morning_fno_brief — 每日 NIFTY/BANKNIFTY F&O 简报，附带可供审批的交易设置摘要

研究与排名

• scan_watchlist — 对观察列表进行批量排名，让自动化流程呈现最值得买入的标的和风险最高的标的
• get_stock_signal_score — 适合自动化的评分，包含各因素的影响、支撑位和风险
• get_stock_timeline — 汇总新闻、财报、内部人士、大宗交易、情绪、质押和聪明资金的统一信息流
• get_sector_peer_context — 行业强度及同业排名/估值背景
• evaluate_signal_quality — 在声称准确率前，为价格行为核心提供诚实的验证依据

投资组合与风险

• analyze_portfolio — 损益、XIRR、行业集中度、风险标记、多元化评分
• get_mf_overlap — 根据 AMFI 公开披露计算基金重叠比例
• get_pledge_alert — 通过季度环比变化速度提前预警发起人质押
• scan_pledge_risks — 批量扫描观察列表中的质押风险
• predict_circuit — 预测跌停风险
• detect_pump — 检测小盘股/微型股的拉高出货模式

券商集成（零延迟实时数据）

• Angel One SmartAPI — 实时报价、Level 2 深度、日内 K 线
• Fyers API v3 — 实时报价 + K 线
• ICICI Breeze — 实时报价 + K 线
• Dhan SmartAPI — 实时报价 + K 线
• Upstox API v2 — 实时报价 + K 线

期权与希腊值

• 完整的 NSE 期权链，包含 PCR、未平仓合约、最大痛点
• Black-Scholes 希腊值：Delta、Gamma、Theta、Vega、Rho
• OI 分析、IV 摘要、未平仓合约量最高的行权价

市场情报

• India VIX + 信号、GIFT Nifty 盘前数据
• NSE 内幕交易（SAST 申报）、发起人持股 + 质押比例
• RBI 政策利率、印度宏观数据（CPI、GDP、CAD）
• AMFI 共同基金资金流、印度政府债券收益率曲线
• get_sebi_alerts — SEBI 执法命令追踪器（提前预警市场崩盘）
• get_morning_brief — 上午 8:15 盘前简报

前所未有的功能（印度专属）

• correlate_gst_to_stocks — 将 GST 月度数据作为 1-3 个月行业领先指标
• get_agm_brief — AGM/EGM 异常决议检测器（增债、加薪、质押批准）
• get_insider_signal — SEBI SAST 内部人士买卖模式与未来收益的关联分析
• get_telegram_tracker — Dalal Street 投资建议频道准确性 + 拉高出货评分
• analyze_budget_live — 粘贴财政部长演讲稿 → 即时生成行业/股票信号（2 月 1 日）
• get_budget_impact — 按年份分析联邦预算的历史赢家 + 输家

基本面

• 利润表、资产负债表、现金流量表（印度 + 美国）
• 关键比率：P/E、ROE、利润率、债务/权益、增长
• 公司简介、股息历史（10 年）、股票比较

全球市场 + 加密货币 + 税务

• 美国、欧盟、全球股票 — 报价 + 历史数据
• 加密货币：BTC、ETH、SOL、100 多种币（CoinGecko）
• 外汇：USD/INR、EUR/INR、50 多种货币对
• SEC 申报文件（10-K、10-Q、8-K）
• LTCG/STCG 税务计算器（适用 2024 年 7 月预算规则 — 其他产品都没有）

---

准确性与评估

FinStack 应定位为决策支持引擎，而非保证预测准确的机器。

• get_stock_signal_score 是用于初筛、筛选和自动化的排序层
• evaluate_signal_quality 是针对价格行为核心功能的诚实验证层
• 完整的实时系统还会使用情绪、内部人士活动、质押风险、宏观因素和同行背景，因此不应将单个回测数字宣传为“FinStack 的准确率”
• 面向用户最稳妥的表述：signal engine、research assistant、multi-factor ranking 和 decision-support

---

与印度市场工具的比较

功能	finstack-mcp	Screener.in	Tickertape	Sensibull	Trendlyne	TradingView
AI Agent 讨论股票	✅	❌	❌	❌	❌	❌
社交情绪（Reddit + StockTwits）	✅	❌	❌	❌	❌	❌
Nifty 走势概率	✅	❌	❌	❌	❌	❌
Telegram 投资建议频道追踪器	✅	❌	❌	❌	❌	❌
预算演讲实时分析器	✅	❌	❌	❌	❌	❌
GST → 行业股票预测器	✅	❌	❌	❌	❌	❌
拉高出货检测器	✅	❌	❌	❌	❌	❌
发起人质押预警	✅	❌	✅ 付费	❌	✅ 付费	❌
期权希腊值	✅ 免费	❌	❌	✅ ₹1,300/月	❌	✅ 付费
FII/DII 资金流	✅ 免费	❌	✅	✅	✅ 付费	❌
基本面（P/E、ROE 等）	✅ 免费	✅ 免费	✅	❌	✅	✅ 付费
可在 Claude / Cursor 中使用	✅	❌	❌	❌	❌	❌
价格	免费	₹4,999/年	₹2,800/年	₹15,600/年	₹4,950/年	$168/年

---

实时数据（可选）

无需设置：数据延迟 15 分钟（yfinance — 免费，无需 API 密钥）。 使用 Angel One：零延迟、Level 2 订单簿、日内 K 线。

pip install finstack-mcp[broker]

ANGEL_API_KEY=your_key
ANGEL_CLIENT_ID=your_client_id
ANGEL_PASSWORD=your_pin
ANGEL_TOTP_SECRET=your_totp_secret

在 smartapi.angelbroking.com 免费注册账户。你的密钥保存在本地 .env 中 — 不会离开你的设备。

也支持其他券商：Fyers、ICICI Breeze、Dhan、Upstox。

---

数据源

来源	涵盖内容	是否需要密钥
yfinance	NSE/BSE/美国股票、加密货币、外汇、历史数据	不需要
NSE direct API	FII/DII、期权链、内幕交易、公司行动	不需要
BSE India API	信用评级、ESG/BRSR	不需要
SEC EDGAR	美国申报文件（10-K、10-Q、8-K）	不需要
CoinGecko	加密货币市场数据	不需要
World Bank	印度宏观数据：CPI、GDP、CAD	不需要
AMFI / mfapi.in	共同基金 NAV、AUM、SIP 资金流	不需要
StockTwits	交易者情绪（预先标记为看涨/看跌）	不需要
Reddit (praw)	r/IndiaInvestments + r/DalalStreetTalks	可选，免费
Finance Ministry	月度 GST 征收数据	不需要
SEBI public filings	执法令、内幕交易 SAST 披露	不需要
Angel One SmartAPI	NSE 实时数据、Level 2 深度、日内数据	免费账户

---

故障排除

安装后 Claude 提示“找不到 finstack”

• 完全重启 Claude Desktop（从系统托盘退出，而不只是关闭窗口）
• Windows 上的配置路径：%APPDATA%\Claude\claude_desktop_config.json
• 验证 Python 是否已加入 PATH：python --version

pip install 失败

python -m pip install --upgrade pip
pip install finstack-mcp

Angel One TOTP 失败

• TOTP 密钥 ≠ 密码。在 Angel One 应用中找到：Profile → Enable TOTP → secret key
• 安装：pip install finstack-mcp[broker]

---

开发

git clone https://github.com/finstacklabs/finstack-mcp.git
cd finstack-mcp
pip install -e .[dev]
pytest -q

欢迎提交 PR。要添加新的券商：创建 src/finstack/data/broker_X.py 并在 tools/ 中注册。

---

链接

• PyPI：https://pypi.org/project/finstack-mcp/
• 主页：https://finstacklabs.github.io/
• YouTube：https://youtu.be/PWK89gBbHEM
• X：https://x.com/finstacklabs1

---

MIT 许可证 · finstacklabs.github.io