内容
# Groww MCP 服务器
[](https://www.ruby-lang.org/)
[](https://modelcontextprotocol.io/)
[](LICENSE)
[](https://groww.in/trade-api)
> **最完整的 Groww MCP 服务器** — 25 种工具、自动 TOTP 身份验证、智能订单（GTT/OCO）、期权链和希腊字母，以及回测。其他 Groww MCP 服务器都没有这些功能。
一个 [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) 服务器，用于将 AI 助手（Claude、GPT、Gemini）连接到 [Groww](https://groww.in/) 交易平台。通过自然语言交易股票、管理投资组合、下达 F&O 订单并访问实时市场数据。
使用 Ruby 构建，由官方 [MCP Ruby SDK](https://github.com/modelcontextprotocol/ruby-sdk) 提供支持。
### 主要亮点
- **25 种工具** — 最全面的 Groww MCP 服务器
- **零手动身份验证** — 自动 TOTP 令牌生成（无需每日网站访问）
- **智能订单** — 支持 GTT 和 OCO（仅此 Groww MCP 服务器支持）
- **期权链** — 包含希腊字母（Δ、Γ、Θ、ν）用于期权分析
- **适用于** — Claude Code、Claude Desktop、任何 MCP 兼容的 AI 助手
## 为什么选择这个 MCP 服务器？
| 功能 | groww-mcp（此服务器） | [darved2305](https://github.com/darved2305/groww-mcp)（TS） | [arkapravasinha](https://github.com/arkapravasinha/groww-mcp-server)（Python） | [karthik1729](https://github.com/karthik1729/groww-mcp)（Go） |
|---------|:-:|:-:|:-:|:-:|
| **工具** | **25** | 23（许多已损坏） | ~20 | 15 |
| **自动 TOTP 身份验证** | ✅ | ❌ | ❌ | ❌ |
| **令牌自动刷新** | ✅ | ❌ | ❌ | ❌ |
| **3 种身份验证方法** | ✅ | 仅限令牌 | 仅限 API 密钥 | 仅限令牌 |
| **智能订单（GTT/OCO）** | ✅ | ❌ | ❌ | ❌ |
| **期权链 + 希腊字母** | ✅ | ❌ | ❌ | ❌ |
| **仪器搜索** | ✅ | ❌ | ✅ | ❌ |
| **回测** | ✅ | ❌ | ❌ | ❌ |
| **正确的 API 路径** | ✅ | ❌ | ✅ | ✅ |
| **F&O 支持** | ✅ | ❌ | ✅ | ✅ |
| **订阅提示** | ✅ | ❌ | ❌ | ❌ |
| **官方 MCP SDK** | ✅ | ✅ | ✅ | 自定义 |
| **语言** | Ruby | TypeScript | Python | Go |
## 快速入门
### 先决条件
- Ruby >= 3.1.0（测试版本为 4.0.1）
- 具有 API 访问权限的 [Groww](https://groww.in/) 交易账户
### 安装
```bash
git clone https://github.com/developerjai/groww-mcp.git
cd groww-mcp
bundle install
```
### 配置
```bash
cp .env.example .env
```
使用您的 Groww 凭证编辑 `.env`（请参见下面的 [身份验证](#authentication)）。
### 连接到 Claude Code
将以下内容添加到您的 `.mcp.json`：
```json
{
"mcpServers": {
"groww": {
"type": "stdio",
"command": "ruby",
"args": ["/path/to/groww-mcp/bin/groww-mcp"],
"env": {
"GROWW_TOTP_KEY": "your_totp_key",
"GROWW_TOTP_SECRET": "your_totp_secret"
}
}
}
}
```
或与 **Claude Desktop** 结合使用 - 将以下内容添加到 `claude_desktop_config.json`：
```json
{
"mcpServers": {
"groww": {
"command": "ruby",
"args": ["/path/to/groww-mcp/bin/groww-mcp"]
}
}
}
```
## 身份验证
Groww MCP 服务器支持 **3 种身份验证方法**。请选择适合您工作流程的方法：
### 方法 1：TOTP（推荐）
**全自动。** 无需每日手动步骤。服务器使用 TOTP 密钥自动生成访问令牌。
#### 设置（一次性，2 分钟）：
1. 访问 [groww.in](https://groww.in/) → 登录
2. 导航到 **个人资料** → **设置** → **交易 API**
3. 点击 **"生成 API 密钥"** 下拉菜单 → **"生成 TOTP 令牌"**
4. 您将获得两个值：
- **TOTP 令牌** （一个以 `eyJ...` 开头的长 JWT 字符串）→ 这是您的 `GROWW_TOTP_KEY`
- **TOTP QR 密钥** （一个类似 `UG3X...` 的短 base32 字符串）→ 这是您的 `GROWW_TOTP_SECRET`
5. 添加到您的 `.env`：
```bash
GROWW_TOTP_KEY=eyJraWQi...your_totp_jwt_key
GROWW_TOTP_SECRET=UG3XTATB22XLH5SGGLHHV736PEOYUZSB
```
就这样。服务器将自动生成新的访问令牌。无需手动步骤，无需每日网站访问。
### 方法 2：API 密钥 + 秘密（批准）
需要 **每日批准** 在 Groww 网站上，然后服务器才能生成令牌。
#### 设置：
1. 访问 [groww.in](https://groww.in/) → **设置** → **交易 API**
2. 点击 **"生成 API 密钥"** → 创建密钥
3. 复制 API 密钥和 API 秘密
4. 添加到 `.env`：
```bash
GROWW_API_KEY=eyJraWQi...your_api_key
GROWW_API_SECRET=your_api_secret
```
5. **每日**：访问交易 API 页面并点击 "批准" 在您的密钥旁边
### 方法 3：直接访问令牌（手动）
用于快速测试。令牌每天 **凌晨 6:00 IST** 过期。
1. 访问 [groww.in](https://groww.in/) → **设置** → **交易 API**
2. 点击 **"生成 API 密钥"** 下拉菜单 → **"生成访问令牌"**
3. 复制令牌
4. 添加到 `.env`：
```bash
GROWW_ACCESS_TOKEN=eyJraWQi...your_access_token
```
> ⚠️ 您需要每天在 **凌晨 6:00 IST** 之前重新生成此令牌。
## 工具
### 投资组合（免费）
| 工具 | 描述 |
|------|-------------|
| `get_holdings` | 您账户中的所有股票，平均价格、数量、ISIN |
| `get_positions` | 开仓的当日/期权仓位，浮动盈亏 |
| `get_margins` | 可用现金、抵押品、权益和期权保证金详情 |
| `calculate_margin` | 下单前检查保证金要求 |
### 订单（免费）
| 工具 | 描述 |
|------|-------------|
| `get_orders` | 列出所有订单，状态可过滤 |
| `get_order_detail` | 特定订单的详细状态 |
| `get_order_trades` | 特定订单的部分成交详情 |
| `place_order` | 下达买入/卖出订单（市价、限价、止损、止损市价） |
| `modify_order` | 修改待处理订单（价格、数量、类型） |
| `cancel_order` | 取消开仓/待处理订单 |
### 智能订单 — GTT/OCO（免费）
| 工具 | 描述 |
|------|-------------|
| `get_smart_orders` | 列出所有 GTT 和 OCO 订单 |
| `create_smart_order` | 创建 GTT（触发）或 OCO（止损 + 目标） |
| `modify_smart_order` | 更新触发、数量和价格 |
| `cancel_smart_order` | 取消待处理智能订单 |
> **GTT** （有效至触发）：当价格达到目标时自动下达订单。
> **OCO** （一个取消另一个）：同时设置止损和目标 — 先触发哪个就执行哪个。
### 市场数据（₹499/月订阅）
| 工具 | 描述 |
|------|-------------|
| `get_quote` | 实时报价，包含 OHLC、买卖价、成交量、涨跌幅 |
| `get_ltp` | 一次获取最多 50 个符号的最新成交价 |
| `get_ohlc` | 最多 50 个符号的 OHLC 数据 |
| `get_option_chain` | 完整的期权链，包含 OI、IV 和希腊字母（Δ、Γ、Θ、ν） |
| `get_historical_data` | 历史 K 线数据用于分析 |
> 市场数据工具需要 [Groww Live Data 订阅](https://groww.in/trade-api)（₹499 + GST/月）。如果没有订阅，这些工具将返回一个明确的错误消息，说明如何订阅。
### 仪器（免费）
| 工具 | 描述 |
|------|-------------|
| `search_instruments` | 按名称或符号查找股票、期权、ETF |
| `get_instrument_detail` | 批次大小、最小变动价位、到期日、合约详情 |
| `download_instruments` | 所有可交易仪器的完整 CSV 文件 |
### 回测（₹499/月订阅）
| 工具 | 描述 |
|------|-------------|
| `run_backtest` | 在历史数据上模拟交易策略 |
### 其他
| 工具 | 描述 |
|------|-------------|
| `authenticate` | 手动触发令牌刷新（通常自动处理） |
| `get_profile` | 账户信息：UCC、交易所、板块、DDPI 状态 |
## Groww API 速率限制
| 类别 | 请求/秒 | 请求/分钟 |
|----------|:---:|:---:|
| 订单（创建、修改、取消） | 10 | 250 |
| 实时数据（报价、LTP、OHLC） | 10 | 300 |
| 非交易（订单、持仓、仓位） | 20 | 500 |
## 示例
连接后，您可以使用自然语言与 AI 助手交互：
```
"显示我的当前持仓"
"我的可用保证金是多少？"
"下达 10 股 RELIANCE 的限价买入订单，价格为 ₹2,800"
"取消订单 ORD123456"
"获取 INFY 的当前价格"（需要实时数据订阅）
```
## 项目结构
```
groww-mcp/
├── bin/
│ └── groww-mcp # 可执行入口点
├── lib/
│ ├── groww_mcp.rb # 主模块，工具注册（25 种工具）
│ └── groww_mcp/
│ ├── version.rb # 版本信息
│ ├── auth.rb # 3 种身份验证方法（TOTP、批准、手动）
│ ├── client.rb # Groww API 客户端（net/http，正确的端点）
│ ├── base_tool.rb # 共享工具助手
│ └── tools/
│ ├── auth_tools.rb # authenticate
│ ├── portfolio_tools.rb # holdings, positions, margins
│ ├── order_tools.rb # place, modify, cancel, list, detail
│ ├── smart_order_tools.rb # GTT, OCO (create, modify, cancel, list)
│ ├── market_tools.rb # quote, LTP, OHLC, historical
│ ├── option_chain_tools.rb # option chain, order trades, backtest
│ ├── instrument_tools.rb # search, detail, CSV download
│ └── user_tools.rb # profile
├── .env.example # 配置模板
├── Gemfile # 依赖项
├── groww-mcp.gemspec # Gem 规范
├── LICENSE # MIT
└── README.md # 此文件
```
## 重要注意事项
- **访问令牌每天凌晨 6:00 IST 过期。** TOTP 身份验证自动处理此问题。
- **SEBI 合规性**：Groww 需要静态 IP 地址进行订单下达。在交易 API → "添加静态 IP 地址" 中注册您的 IP 地址。
- **实时数据** （报价、LTP、OHLC、历史数据）需要 ₹499/月订阅。
- **订单下达** 执行真实交易，涉及真实资金。AI 将在下达订单前始终确认。
## 其他 Groww MCP 服务器
寻找替代方案？以下是所有可用的 Groww MCP 服务器：
| 项目 | 语言 | 工具 | 亮点 | 限制 |
|---------|----------|:-----:|------------|-------------|
| **[groww-mcp](https://github.com/developerjai/groww-mcp)** （此服务器） | Ruby | 25 | 自动 TOTP、GTT/OCO、期权链、回测 | — |
| [darved2305/groww-mcp](https://github.com/darved2305/groww-mcp) | TypeScript | 23 | 模拟模式、SIP/MF 工具 | 错误的 API 路径、损坏的端点 |
| [arkapravasinha/groww-mcp-server](https://github.com/arkapravasinha/groww-mcp-server) | Python | ~20 | 11 种技术分析工具 | 无自动身份验证、无智能订单 |
| [venkatakaushikvemani/groww-mcp](https://github.com/venkatakaushikvemani/groww-mcp) | TypeScript | 8 | 已发布 npm、基于意图的路由 | 工具集最小 |
| [karthik1729/groww-mcp](https://github.com/karthik1729/groww-mcp) | Go | 15 | 正确的 API 路径、保证金计算器 | 无自动身份验证、无期权链 |
## 为 Groww 而建
该项目基于 [Groww Trade API](https://groww.in/trade-api) 构建，使算法和 AI 辅助交易对每个 Groww 用户都可访问。
**[@AskGroww](https://twitter.com/AskGroww)** — 如果您来自 Groww 团队，我很乐意合作。此 MCP 服务器通过开放的 [MCP 标准](https://modelcontextprotocol.io/) 使您的 Trade API 可供每个 AI 助手（Claude、GPT、Gemini）访问。让我们使 Groww 成为印度最 AI 友好的经纪商。
## 贡献
欢迎贡献！无论是修复 bug、新工具、文档改进还是想法建议，都欢迎 PR。
请参阅 [CONTRIBUTING.md](CONTRIBUTING.md) 获取指南。
**一些让您开始的想法：
- 添加对共同基金工具的支持（SIP、赎回、NAV）
- 改进错误消息和边缘情况处理
- 添加具有模拟 API 响应的测试
- 不同 AI 助手的文档和示例
## 许可证
[MIT](LICENSE) — Jai Rajput
## 作者
**Jai Rajput** — CTO & AI 工程师
- GitHub: [@developerjai](https://github.com/developerjai)
- LinkedIn: [Jai Rajput](https://www.linkedin.com/in/developer-jairajput/)
构建印度市场的 AI 工具。如果这个项目对您有帮助，请考虑给它一个星级！
