AI导哈

交易账户LLM交互服务器

Groww MCP服务器是一个为Groww交易平台设计的模型上下文协议服务器，使LLM应用能够与Groww交易账户进行交互，支持订单管理、投资组合查看、市场数据获取等功能。

  • by abhijeetmohanan
  • Python
  • 本地部署
  • 5 星标
  • 更新于
在 GitHub 查看 abhijeetmohanan/growwmcp

使用说明

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（盘后订单）排队等待下一个交易日。

相关 MCP