内容
# InvestSights — 印度股票研究 MCP 服务器
**用于深入印度股票研究的模型上下文协议服务器 — 基本面、法医会计评分、DCF 估值、筛选、价格、技术面和 6000+ 只 NSE 和 BSE 股票的新闻，由 Claude、ChatGPT、Perplexity、Cursor 和任何 AI 助手提供。**
[](https://www.npmjs.com/package/investsights-mcp)
[](https://www.npmjs.com/package/investsights-mcp)
[](LICENSE)
[](https://modelcontextprotocol.io/)
[文档](https://investsights.in/mcp) •
[快速入门](#快速入门) •
[工具](#工具) •
[示例提示](#示例提示) •
[npm](https://www.npmjs.com/package/investsights-mcp)
---
## 这是什么？
InvestSights MCP 是一个 [模型上下文协议](https://modelcontextprotocol.io/) 服务器，它将 AI 助手连接到 **研究级印度股票市场数据** — 与 [investsights.in](https://investsights.in) 相同的引擎。
大多数市场服务器只提供报价和筛选，而 InvestSights 添加了一个研究层：**法医会计评分**（Piotroski F、Beneish M、Altman Z — 银行感知 CAMELS 处理）、**多阶段 DCF + 相对估值**、**分析师共识**、股权结构和精选新闻 — 适用于 6000+ 只 NSE/BSE 公司。
**兼容:** Claude.ai、Claude Desktop、Claude Code、ChatGPT、Perplexity、Cursor、Windsurf、VS Code（Copilot）、Kiro、Zed、Codex、Gemini、Grok、OpenCode 和任何 MCP 兼容客户端。
## 快速入门
### 选项 1：带有 OAuth 的远程 MCP（claude.ai、ChatGPT、Perplexity、Grok）
将此 URL 添加为 AI 聊天应用程序中的自定义连接器：
```
https://investsights.in/api/v2/mcp-public/mcp
```
首次使用时，会打开浏览器 — 使用您的 InvestSights 帐户（Google 登录）登录并在同意屏幕上批准访问。无需令牌。
### 选项 2：带有令牌的远程 MCP（Claude Code、VS Code、Kiro、Zed）
对于支持基于 URL 的 MCP 服务器且带有自定义标头的代码编辑器：
1. 在 [investsights.in/account/connected-apps](https://investsights.in/account/connected-apps) 获取免费密钥
2. 添加到您的 MCP 配置：
```json
{
"mcpServers": {
"investsights": {
"type": "url",
"url": "https://investsights.in/api/v2/mcp-public/mcp",
"headers": {
"Authorization": "Bearer usk_YOUR_KEY_HERE"
}
}
}
}
```
> 只支持 URL 的客户端（无标头支持）？使用 URL 中的密钥：
> `https://investsights.in/api/v2/mcp-public/usk_YOUR_KEY_HERE/mcp`
### 选项 3：通过 npm 进行本地 MCP（Cursor、Windsurf、Claude Desktop、Codex、Gemini CLI）
适用于基于 stdio 的 MCP 客户端。无需克隆或构建 — 通过 `npx` 运行：
1. 在 [investsights.in/account/connected-apps](https://investsights.in/account/connected-apps) 获取免费密钥
2. 添加到您的 MCP 配置：
```json
{
"mcpServers": {
"investsights": {
"command": "npx",
"args": ["-y", "investsights-mcp"],
"env": {
"INVESTSIGHTS_TOKEN": "usk_YOUR_KEY_HERE"
}
}
}
}
```
> **Node.js 18+** 需要本地选项。运行 `node --version` 进行检查。
## 它是如何工作的？
```
┌─────────────────┐ stdio (JSON-RPC) ┌───────────────────┐ HTTPS ┌─────────────────────┐
│ AI 助手 │ ◄──────────────────► │ investsights-mcp │ ◄───────────► │ investsights.in │
│ （Claude 等） │ │ （npm 包） │ │ （研究后端） │
└─────────────────┘ └───────────────────┘ └─────────────────────┘
```
npm 包是一个轻量级的 stdio 桥（约 250 行，**零运行时依赖**）。它：
- 从标准输入读取 JSON-RPC，转发到远程 InvestSights MCP 服务器，写入标准输出响应
- 自动检测帧：`Content-Length`（VS Code、Claude Desktop）或换行符分隔的 JSON（Claude Code、Kiro）
- 使用您的个人密钥作为 Bearer 令牌验证每个请求
- 处理来自远程服务器的 SSE 响应
**所有工具及其逻辑都在远程服务器上运行 — npm 包只是传输层。**
## 身份验证
| 方法 | 工作原理 | 最适合 |
| --- | --- | --- |
| **OAuth（Google 登录）** | 浏览器登录 + 同意屏幕，可随时撤销 | AI 聊天应用程序（claude.ai、ChatGPT、Perplexity、Grok） |
| **个人密钥（远程）** | `Authorization: Bearer usk_...` 标头，或 URL 中的密钥 | 代码编辑器与基于 URL 的 MCP（VS Code、Kiro、Zed） |
| **个人密钥（本地）** | `INVESTSIGHTS_TOKEN` 环境变量通过 npx | stdio MCP 客户端（Cursor、Windsurf、Claude Desktop） |
在 [investsights.in/account/connected-apps](https://investsights.in/account/connected-apps) 创建和撤销密钥。所有方法都有相同的免费限制。
## 工具
精选的快速只读研究工具包 — 您的 AI 自动选择合适的工具。
### 🏢 公司研究
| 工具 | 描述 |
| --- | --- |
| `get_stock_financials` | 基本面和关键比率 — 市盈率、市净率、净资产收益率、资本回报率、负债率、利润率、增长率。 |
| `get_shareholding` | 控股模式随时间变化 — 控股人、FII、DII 和公众。 |
| `get_stock_comparison` | 基本面、估值和技术面对比。 |
### 🔬 质量与估值
| 工具 | 描述 |
| --- | --- |
| `get_forensic_score` | 法医会计检查 — Piotroski F 评分、Beneish M 评分、Altman Z 评分。银行感知：金融数据根据 CAMELS 而非制造业模型进行评估。 |
| `get_valuation` | 多阶段 DCF 估值，包含牛市、基准和熊市情景及敏感性分析，以及与同行相对的估值 — 在服务器端计算，绝不臆测。 |
| `get_analyst_consensus` | 分析师估计、评级和共识。 |
### 📊 筛选
| 工具 | 描述 |
| --- | --- |
| `screen_stocks` | 跨基本面、质量和动量的多因素股票筛选。 |
### 📈 价格与技术面
| 工具 | 描述 |
| --- | --- |
| `get_price_history` | 每日 OHLCV 历史数据，附技术背景。 |
| `get_technical_indicators` | RSI、移动平均线（5/20/50/200）等。 |
### 📰 市场与新闻
| 工具 | 描述 |
| --- | --- |
| `get_market_overview` | 印度市场的指数、 breadth 和板块快照。 |
| `get_stock_news` | 精选的 AI 总结的股票新闻。 |
| `get_earnings_calendar` | 财报日期和经济事件。 |
> **企业：** 完整的 40+ 工具目录 — GraphRAG 文档智能、财报分析、公司治理图谱、超级投资者跟踪、投资组合分析 — 适用于专用密钥和自定义限制。联系 **connect@investsights.in**。
## 示例提示
### 股票研究
```
"比较 HDFC Bank 和 ICICI Bank — 当前的利润增长、净资产收益率、估值和股权趋势"
"提取 TCS 的基本面和股权结构 — FII 持股正在上升还是下降？"
```
### 法医质量
```
"对 Suzlon 进行法医会计检查 — Piotroski、Beneish 和 Altman。 有任何红旗吗？"
"从法医评分来看，哪家公司在财务上更健康：Zomato 还是 Swiggy？"
```
### 估值
```
"TCS 当前股价的 DCF 估值是多少？ 显示牛市、基准和熊市情景及关键假设"
```
### 筛选 + 技术面
```
"寻找净资产收益率 > 18%、低负债和 RSI 小于 40 的股票 — 超卖的质量股"
"筛选利润率改善和市盈率低于 20 的中盘股 — 前 15 名"
```
### 市场简报
```
"今日印度市场概况 — 指数走势、强势板块和本周财报日历"
```
## 数据覆盖
| 类别 | 包含内容 |
| --- | --- |
| **股票** | 6000+ 只 NSE 和 BSE 上市公司 |
| **基本面** | 关键比率、增长指标、季度和年度数据 |
| **法医** | Piotroski F 评分、Beneish M 评分、Altman Z 评分 — 银行感知（CAMELS） |
| **估值** | 多阶段 FCFF DCF（情景 + 敏感性）、与同行相对的估值 |
| **筛选器** | 163 个基本面 + 质量 + 动量过滤器 |
| **价格和技术面** | 日终 OHLCV、RSI、MA-5/20/50/200 |
| **所有权** | 控股人 / FII / DII / 公众持股随时间变化 |
| **新闻和事件** | AI 总结的股票新闻、财报日历、经济事件 |
## 环境变量
| 变量 | 是否必需 | 默认值 | 描述 |
| --- | --- | --- | --- |
| `INVESTSIGHTS_TOKEN` | 是（本地） | — | 个人密钥来自 [investsights.in/account/connected-apps](https://investsights.in/account/connected-apps) |
| `INVESTSIGHTS_MCP_URL` | 否 | `https://investsights.in/api/v2/mcp-public/mcp` | 覆盖远程服务器 URL |
| `INVESTSIGHTS_DEBUG` | 否 | `0` | 设置为 `1` 以进行 stderr 调试日志记录 |
## 速率限制
| 计划 | 每分钟 | 每日 |
| --- | --- | --- |
| 免费（每个注册帐户） | 10 个请求 | 100 个请求 |
| 专业版 | 30 个请求 | 1000 个请求 |
团队和平台可获得更高的限制和完整的工具目录 — **connect@investsights.in**。
## 故障排除
| 问题 | 解决方案 |
| --- | --- |
| `INVESTSIGHTS_TOKEN 环境变量是必需的` | 将您的密钥添加到 MCP 配置的 `env` 部分 |
| `身份验证失败（401）` | 密钥被撤销或输入错误 — 在 [investsights.in/account/connected-apps](https://investsights.in/account/connected-apps) 创建一个新的密钥 |
| `速率限制超出` | 等待窗口重置或升级以获得更高的限制 |
| 服务器无响应 | 确保已安装 Node.js 18+（`node --version`） |
| 网络错误 | 桥接器需要访问 `investsights.in` |
设置 `INVESTSIGHTS_DEBUG=1` 以进行详细的 stderr 日志记录。
## 链接
- **[investsights.in](https://investsights.in)** — 网络平台
- **[investsights.in/mcp](https://investsights.in/mcp)** — MCP 文档和设置指南
- **[investsights.in/docs](https://investsights.in/docs)** — 完整的开发者和工具参考
- **[npm: investsights-mcp](https://www.npmjs.com/package/investsights-mcp)** — npm 包
## 合规性
InvestSights 是一个分析平台，**不是 SEBI 注册的** 研究分析师或投资顾问。每个工具都是 **只读** 的，返回数据、比率和评分 — 绝不提供买卖推荐、目标价格或个性化建议。所有输出均为教育目的；请在投资前咨询 SEBI 注册的顾问。证券市场投资存在市场风险。
## 贡献
欢迎为桥接本身提交问题和拉取请求。对于错误，请包括错误消息和您的 MCP 客户端名称/版本。
## 许可证
[MIT](LICENSE) — 桥接是免费使用、修改和分发的。InvestSights 平台及其数据服务是专有的。
---
由 [InvestSights](https://investsights.in) 构建 — **SocialCoffee DigiTech Pvt Ltd** 的产品
