Grow-MCP服务器
MCP(模型上下文协议)服务器 成长 交易平台。这使得LLM应用程序能够与您的Groww交易账户进行交互。
特性
- 订单:在股票、F&O和商品之间下达、修改、取消和列出订单
- 投资组合:查看持股和头寸
- 市场数据:获取报价、LTP、OHLC和历史蜡烛数据
- 仪器:搜索和查找交易工具
- 边距:检查可用保证金并计算订单保证金要求
- 直播源:通过WebSocket订阅实时价格更新
安装
使用Docker(推荐)
docker pull abhijeet45/growwmcp:latest使用uvx
uvx --from git+https://github.com/abhijeetmohanan/growwmcp.git growmcp使用pip
pip install git+https://github.com/abhijeetmohanan/growwmcp.git来源
git clone https://github.com/abhijeetmohanan/growwmcp.git
cd growwmcp
pip install -e .配置
环境变量
设置您的Grow API凭据:
# Option 1: API Key + Secret (requires daily approval)
export GROWW_API_KEY=your_api_key
export GROWW_API_SECRET=your_api_secret
# Option 2: TOTP Flow (no expiry - recommended)
export GROWW_TOTP_TOKEN=your_totp_token
export GROWW_TOTP_SECRET=your_totp_secret从获取您的API证书 增长贸易API.
MCP配置
添加到您的 .mcp.json (项目级)或MCP客户端配置:
使用Docker:
{
"mcpServers": {
"groww": {
"command": "docker",
"args": ["run", "--rm", "-i", "-e", "GROWW_API_KEY", "-e", "GROWW_API_SECRET", "abhijeet45/growwmcp:latest"],
"env": {
"GROWW_API_KEY": "${GROWW_API_KEY}",
"GROWW_API_SECRET": "${GROWW_API_SECRET}"
}
}
}
}使用uvx:
{
"mcpServers": {
"groww": {
"command": "uvx",
"args": ["--from", "git+https://github.com/abhijeetmohanan/growwmcp.git", "growmcp"],
"env": {
"GROWW_API_KEY": "${GROWW_API_KEY}",
"GROWW_API_SECRET": "${GROWW_API_SECRET}"
}
}
}
}可用工具
订单管理
| 工具 | 说明 |
|---|---|
place_order | 下新订单(买入/卖出) |
modify_order | 修改现有订单 |
cancel_order | 取消待处理订单 |
get_order_list | 列出所有订单(待定、已执行、已取消) |
get_order_status | 获取特定订单的状态 |
get_order_detail | 获取详细的订单信息 |
get_trades_for_order | 执行订单交易 |
投资组合
| 工具 | 说明 |
|---|---|
get_holdings | 获取DEMAT持有量 |
get_positions | 获取当前职位 |
get_position_by_symbol | 获取特定符号的位置 |
市场数据
| 工具 | 说明 |
|---|---|
get_quote | 获取仪器的实时报价 |
get_ltp | 获取最后交易价格(最多50个交易品种) |
get_ohlc | 获取OHLC数据(最多50个符号) |
get_historical_candles | 获取历史蜡烛数据 |
仪器
| 工具 | 说明 |
|---|---|
search_instrument_by_groww_symbol | 按Groww符号搜索 |
search_instrument_by_trading_symbol | 按交易所+交易代码搜索 |
search_instrument_by_exchange_token | 按交易所代币搜索 |
search_instruments | 按模式搜索仪器 |
get_all_instruments_summary | 获取仪器数据库摘要 |
边距
| 工具 | 说明 |
|---|---|
get_available_margin | 获得各细分市场的可用利润 |
calculate_order_margin | 计算订单所需的保证金 |
实时馈送(WebSocket)
| 工具 | 说明 |
|---|---|
subscribe_ltp | 订阅LTP更新 |
get_live_ltp | 从订阅中获取实时LTP |
unsubscribe_ltp | 取消订阅LTP更新 |
subscribe_market_depth | 订阅订单更新 |
get_market_depth | 获取实时市场深度 |
subscribe_index_value | 订阅索引更新 |
get_index_value | 获取实时索引值 |
subscribe_order_updates | 订阅订单状态更新 |
subscribe_position_updates | 订阅职位更新 |
用法示例
配置后,您可以与您的交易账户进行交互:
- “我持有的股票是什么?”
- “我的待处理订单是什么?”
- “以市场价格购买10股RELIANCE”
- “TCS的当前价格是多少?”
- “显示NIFTY的历史数据”
- “我有多少可用的保证金?”
- “寻找白银ETF”
支持的交易所和细分市场
| 交换 | 细分 |
|---|---|
| NSE | 现金,FNO |
| 现金 | |
| MCX | 商品 |
速率限制
| 类别 | 每秒 | 每分钟 |
|---|---|---|
| 订单 | 15 | 250 |
| 实时数据 | 10 | 300 |
| 非交易 | 20 | 500 |
实时订阅源:最多1000个并发订阅。
重要说明
- TPIN验证:出售DEMAT资产需要通过Groww应用程序/网站进行手动TPIN验证。这无法通过API实现自动化。
- API批准:如果使用API密钥+密钥方法,则需要每天在Grow上批准访问。
- 市场交易时间:订单只能在市场时间(印度标准时间上午9:15-下午3:30)下。AMO(盘后订单)排队等待下一个交易日。
