Groww MCP Server

🚀 Groww MCP 服务器

Groww MCP 服务器是一个全面的模型上下文协议（MCP）服务器，适用于 Groww 交易 API。该服务器提供了与 Groww 交易平台进行交互的工具，让你能够下单、管理投资组合、获取实时市场数据等。

🚀 快速开始

在使用本服务器前，请确保你已经满足以下先决条件并完成相应配置：

先决条件

1. Groww 账户：你需要一个已启用期货和期权（F&O）交易的 Groww 账户。
2. API 订阅：拥有有效的交易 API 订阅（每月 499 卢比 + 税费）。
3. API 密钥：从 Groww 账户设置中生成你的 API 访问令牌。

生成 API 密钥

1. 登录你的 Groww 账户。
2. 点击右上角的个人资料部分。
3. 点击设置图标。
4. 导航至“交易 API”。
5. 创建并管理你的 API 令牌。

配置

服务器需要以下配置：

{
  "apiKey": "your_groww_api_key_here",
  "debug": false
}

✨ 主要特性

本 MCP 服务器可访问所有主要的 Groww API 端点：

🔧 交易工具与搜索

• download_instruments_csv - 下载/刷新完整的可交易工具数据。
• search_instruments - 按名称、交易符号、Groww 符号或标准搜索交易工具。
• get_instrument_details - 获取特定交易工具的详细信息。

📋 订单管理

• place_order - 下达新订单（股票、期货和期权）。
• modify_order - 修改现有待处理/未成交订单。
• cancel_order - 取消待处理/未成交订单。
• get_order_status - 通过 Groww 订单 ID 获取订单状态。
• get_order_status_by_reference - 通过用户参考 ID 获取订单状态。
• get_order_list - 获取当天所有订单的列表。
• get_order_details - 获取订单详细信息。
• get_order_trades - 获取订单的所有交易/执行情况。

💼 投资组合管理

• get_holdings - 获取 DEMAT 账户中的当前股票持仓。
• get_positions - 获取所有交易头寸。
• get_position_by_symbol - 获取特定交易符号的头寸。

💰 保证金管理

• get_user_margin - 获取可用保证金详情。
• calculate_margin_requirement - 计算订单所需的保证金。

📊 实时市场数据

• get_live_quote - 获取交易工具的完整实时市场数据。
• get_ltp - 获取多个交易工具（最多 50 个）的最新成交价（LTP）。
• get_ohlc - 获取多个交易工具（最多 50 个）的开盘价、最高价、最低价和收盘价（OHLC）数据。

📈 历史数据

• get_historical_data - 获取交易工具的历史蜡烛图数据。

📊 技术分析

• calculate_moving_averages - 计算简单移动平均线（SMA）和指数移动平均线（EMA）用于趋势分析。
• calculate_rsi - 计算相对强弱指数（RSI）用于动量分析。
• calculate_bollinger_bands - 计算布林带用于波动率分析。
• calculate_support_resistance - 识别关键的支撑和阻力水平。
• calculate_volatility_metrics - 计算各种波动率指标用于风险评估。
• calculate_macd - 计算异同移动平均线（MACD）用于趋势和动量分析。
• calculate_stochastic - 计算随机震荡指标用于动量分析。
• calculate_williams_r - 计算威廉指标 %R 用于动量分析。
• calculate_adx - 计算平均趋向指数（ADX）用于趋势强度分析。
• calculate_fibonacci_levels - 计算斐波那契回撤和扩展水平。
• analyze_candlestick_patterns - 识别常见的蜡烛图形态。

📦 安装指南

文档未提及安装步骤，故跳过此章节。

💻 使用示例

基础用法

搜索交易工具

// 搜索包含 "reliance" 的交易工具
search_instruments({
  query: "reliance",
  exchange: "NSE",
  segment: "CASH",
  limit: 5
})

// 搜索 NIFTY 期权
search_instruments({
  query: "nifty",
  segment: "FNO",
  instrument_type: "CE",
  limit: 10
})

// 获取特定符号的详细信息
get_instrument_details({
  trading_symbol: "RELIANCE",
  exchange: "NSE"
})

下达市价订单

// 以市价买入 10 股 RELIANCE 股票
place_order({
  trading_symbol: "RELIANCE",
  quantity: 10,
  exchange: "NSE",
  segment: "CASH",
  product: "CNC",
  order_type: "MARKET",
  transaction_type: "BUY"
})

高级用法

下达限价订单

// 以每股 250 卢比的价格买入 100 股 WIPRO 股票
place_order({
  trading_symbol: "WIPRO",
  quantity: 100,
  exchange: "NSE",
  segment: "CASH",
  product: "CNC",
  order_type: "LIMIT",
  transaction_type: "BUY",
  price: 250
})

下达止损订单

// 为 RELIANCE 股票下达止损订单
place_order({
  trading_symbol: "RELIANCE",
  quantity: 10,
  exchange: "NSE",
  segment: "CASH",
  product: "CNC",
  order_type: "SL",
  transaction_type: "SELL",
  price: 2450,
  trigger_price: 2400
})

获取实时市场数据

// 获取 NIFTY 的实时报价
get_live_quote({
  trading_symbol: "NIFTY",
  exchange: "NSE",
  segment: "CASH"
})

// 获取多个符号的最新成交价
get_ltp({
  segment: "CASH",
  exchange_symbols: ["NSE_RELIANCE", "NSE_TCS", "NSE_INFY"]
})

获取历史数据

// 获取 RELIANCE 股票的 5 分钟蜡烛图数据
get_historical_data({
  trading_symbol: "RELIANCE",
  exchange: "NSE",
  segment: "CASH",
  start_time: "2024-01-01 09:15:00",
  end_time: "2024-01-01 15:30:00",
  interval_in_minutes: 5
})

技术分析示例

// 计算移动平均线
calculate_moving_averages({
  trading_symbol: "RELIANCE",
  exchange: "NSE", 
  segment: "CASH",
  start_time: "2024-01-01 09:15:00",
  end_time: "2024-01-31 15:30:00",
  periods: [5, 10, 20, 50]
})

// 计算 RSI
calculate_rsi({
  trading_symbol: "NIFTY",
  exchange: "NSE",
  segment: "CASH", 
  start_time: "2024-01-01 09:15:00",
  end_time: "2024-01-31 15:30:00",
  period: 14
})

// 计算布林带
calculate_bollinger_bands({
  trading_symbol: "RELIANCE",
  exchange: "NSE",
  segment: "CASH",
  start_time: "2024-01-01 09:15:00", 
  end_time: "2024-01-31 15:30:00",
  period: 20,
  std_dev: 2
})

// 查找支撑和阻力水平
calculate_support_resistance({
  trading_symbol: "RELIANCE",
  exchange: "NSE",
  segment: "CASH", 
  start_time: "2023-12-01 09:15:00",
  end_time: "2024-01-31 15:30:00",
  interval_in_minutes: 60,
  min_touches: 2
})

// 计算波动率指标
calculate_volatility_metrics({
  trading_symbol: "RELIANCE",
  exchange: "NSE",
  segment: "CASH",
  start_time: "2023-01-01 09:15:00",
  end_time: "2024-01-31 15:30:00", 
  interval_in_minutes: 1440 // 每日蜡烛图
})

// 计算 MACD
calculate_macd({
  trading_symbol: "RELIANCE",
  exchange: "NSE",
  segment: "CASH",
  start_time: "2024-01-01 09:15:00",
  end_time: "2024-01-31 15:30:00",
  fast_period: 12,
  slow_period: 26,
  signal_period: 9
})

// 计算随机震荡指标
calculate_stochastic({
  trading_symbol: "NIFTY",
  exchange: "NSE",
  segment: "CASH",
  start_time: "2024-01-01 09:15:00",
  end_time: "2024-01-31 15:30:00",
  k_period: 14,
  d_period: 3
})

// 计算威廉指标 %R
calculate_williams_r({
  trading_symbol: "RELIANCE",
  exchange: "NSE",
  segment: "CASH",
  start_time: "2024-01-01 09:15:00",
  end_time: "2024-01-31 15:30:00",
  period: 14
})

// 计算平均趋向指数（ADX）用于趋势强度分析
calculate_adx({
  trading_symbol: "RELIANCE",
  exchange: "NSE",
  segment: "CASH",
  start_time: "2024-01-01 09:15:00",
  end_time: "2024-01-31 15:30:00",
  period: 14
})

// 计算斐波那契水平
calculate_fibonacci_levels({
  trading_symbol: "RELIANCE",
  exchange: "NSE",
  segment: "CASH",
  start_time: "2023-12-01 09:15:00",
  end_time: "2024-01-31 15:30:00",
  trend_direction: "AUTO"
})

// 分析蜡烛图形态
analyze_candlestick_patterns({
  trading_symbol: "RELIANCE",
  exchange: "NSE",
  segment: "CASH",
  start_time: "2024-01-25 09:15:00",
  end_time: "2024-01-31 15:30:00",
  lookback_candles: 5
})

计算保证金要求

// 计算一篮子订单的保证金
calculate_margin_requirement({
  segment: "CASH",
  orders: [
    {
      trading_symbol: "RELIANCE",
      transaction_type: "BUY",
      quantity: 10,
      order_type: "LIMIT",
      product: "CNC",
      exchange: "NSE",
      price: 2500
    },
    {
      trading_symbol: "TCS",
      transaction_type: "BUY",
      quantity: 5,
      order_type: "MARKET",
      product: "CNC",
      exchange: "NSE"
    }
  ]
})

📚 详细文档

API 枚举和常量

交易所

• NSE - 印度国家证券交易所
• BSE - 孟买证券交易所

交易板块

• CASH - 常规股票市场
• FNO - 期货和期权

订单类型

• MARKET - 以最佳可用价格立即执行
• LIMIT - 以指定价格或更优价格执行
• SL - 止损订单
• SL_M - 止损市价订单

交易类型

• BUY - 多头头寸
• SELL - 空头头寸

产品类型

• CNC - 现金和交割（基于交割）
• MIS - 日内保证金平仓
• NRML - 常规保证金交易

有效期

• DAY - 有效期至市场收盘

速率限制

Groww API 在类别级别应用了速率限制：

错误处理

服务器处理各种类型的错误：

1. API 认证错误：无效的 API 密钥。
2. 速率限制错误：超出 API 速率限制。
3. 验证错误：无效的参数。
4. 交易错误：市场关闭、保证金不足等。

所有错误都会返回描述性消息，以帮助识别和解决问题。

支持和文档

• Groww API 文档
• 速率限制
• 错误代码

🔧 技术细节

文档未提供具体技术实现细节，故跳过此章节。

📄 许可证

本项目采用 MIT 许可证。

⚠️ 重要提示

• 交易风险警告：
  • 在金融市场交易涉及重大损失风险。
  • 过去的表现并不保证未来的结果。
  • 仅使用你能够承受损失的资金进行交易。
  • 本工具仅用于教育和开发目的。
  • 始终手动验证订单和交易。
  • 开发者不对任何交易损失负责。