Groww MCP服务器

连接Groww交易账户与Claude AI的服务,通过自然语言查询账户信息和执行交易操作。

  • by SAGAR-TAMANG
  • Python
  • 本地部署
  • 22 星标
  • 更新于
在 GitHub 查看 SAGAR-TAMANG/groww-python-mcp

使用说明

🚀 GrowMCP服务器(Python)

用简单的英语向克劳德询问有关Groww帐户的问题。

该项目将您的Groww交易账户连接到Claude(或任何支持MCP的AI)。设置后,您可以键入以下内容 “我目前的投资组合价值是多少?” 或 “显示NIFTY的选项链” 直接在Claude中——不再切换标签。

什么是MCP? 模型上下文协议(MCP)是一个开放标准,允许AI助手连接到外部工具和实时数据。把它想象成一个将克劳德链接到你的Groww帐户的插件。


✨ 它能做什么?

一旦连接,克劳德就可以访问 18工具 在您的整个Groww帐户中:

类别 你可以问克劳德什么
💼 账户和投资组合 “我的可用余额是多少?” / “显示我的资产”
📈 订单管理 “在以下时间发出10股INFY的限价订单₹1800"
🧠 智能订单(GTT/OCO) “如果信任交叉,则设置触发顺序₹2500"
📊 市场数据 “获取TCS和WIPRO的LTP” / “显示OHLC数据”
⚡ 衍生品(FNO) “显示此到期日的第九个选项链” / “这份合同的希腊人是什么?”
See all 18 tools
  • groww_get_profile --您的Groww账户资料
  • groww_get_balance --可用利润和现金余额
  • groww_get_holdings --所有股权持有
  • groww_get_positions --实时头寸(现金或FNO)
  • groww_place_order --市价、限价、SL、SL-M订单
  • groww_modify_order --编辑待处理订单
  • groww_cancel_order --取消未结订单
  • groww_create_smart_order --GTT或OCO智能订单
  • groww_cancel_smart_order --取消智能订单
  • groww_get_smart_order_list --查看所有活动的智能订单
  • groww_get_quote --任何交易品种的完整深度、价格和交易量
  • groww_get_ltp --一次多个交易品种的最后交易价格
  • groww_get_ohlc --多个符号的打开、高、低、关闭
  • groww_get_historical_candles --回溯测试的历史数据
  • groww_get_option_chain --指数/股票的完整期权链
  • groww_get_greeks --实时显示Delta、Theta、Gamma、Vega
  • groww_get_expiries --下一个可用的到期日期
  • groww_get_contracts --所有罢工和到期合同

📺 视频教程

单击上图观看设置指南。


🛠️ 安装指南

所需时间: 大约10分钟。无需具备编码经验。

步骤1——获取代码

选项A(如果你有Git):

git clone https://github.com/SAGAR-TAMANG/groww-python-mcp
cd groww-python-mcp

选项B(无Git):
首选 github/SAGAR-TAMANG/groww-python-mcp,单击绿色 代码 按钮→ 下载ZIP,并将其解压缩。


步骤2——安装 uv

uv 是安装和运行此项目的Python代码的工具。从官方页面安装:

👉 https://docs.astral.sh/uv/getting-started/installation/

选择您的操作系统(Windows/macOS/Linux),并按照其中的一行安装命令进行操作。完成后,您可以验证它是否有效:

uv --version

步骤3-获取Grow API密钥

  1. 首选👉 https://groww.in/trade-api/api-keys
  2. 登录并生成您的 API密钥 和 API秘密
  3. 前几个月提供免费计划

请确保这些物品的安全。 把它们当作密码一样对待——不要分享或提交到GitHub。


步骤4——将密钥添加到项目中

在项目文件夹中,创建一个名为的文件 .env.local (注意开头的圆点)并粘贴您的凭据:

GROWW_API_KEY=your_api_key_here
GROWW_API_SECRET=your_api_secret_here

保存文件。就是这样——你的钥匙完全留在你自己的机器上。

Windows用户: 如果你的文件管理器隐藏了以点开头的文件,你可以在VS Code或任何文本编辑器中使用“另存为”并键入 .env.local 作为文件名。


步骤5——安装依赖项并启动服务器

打开项目文件夹中的终端并运行:

uv sync
uv run main.py

第一个命令安装项目所需的所有内容。第二个启动服务器。您将看到类似以下内容:

Uvicorn running on http://127.0.0.1:8000

保持此终端窗口打开 同时使用克劳德。服务器需要保持运行。


步骤6--连接克劳德桌面

打开克劳德桌面,转到 设置→ 开发者,然后单击 编辑配置 打开 claude_desktop_config.json.

添加以下内容(将路径替换为项目文件夹的实际路径):

{
  "mcpServers": {
    "groww_mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "http://127.0.0.1:8000/sse"
      ]
    }
  }
}

找到你的路:

  • 窗户: 在文件资源管理器中打开项目文件夹,单击地址栏,然后复制路径。更换睫毛 \ 带有正斜杠 /.
  • macOS/Linux: 在终端中,导航到项目文件夹并运行 pwd 打印路径。

保存文件并 重新启动克劳德桌面.Groww现在应该显示为一个连接的工具。


第七步——试试看

在Claude中开始一个新的聊天,并问以下问题:

  • “我目前的增长余额是多少?”
  • “给我看看我的财产。”
  • “RELIANCE和TCS的LTP是什么?”

🔌 连接其他MCP客户端

该服务器并非Claude Desktop独有。任何兼容MCP的客户端都可以通过以下方式连接到它:

  • SSE端点: http://127.0.0.1:8000/sse

在服务器运行时,只需将客户端指向该URL即可。


🧪 使用MCP检查器进行测试(适用于开发人员)

想在连接到Claude之前以交互方式探索和测试所有18个工具吗?使用MCP检查器:

npx @modelcontextprotocol/inspector uv run main.py

这将打开一个浏览器UI,您可以在其中手动调用每个工具并查看实时响应。


❓ 故障排除

Claude没有将Groww显示为连接工具
→ 确保服务器正在运行(uv run main.py)编辑配置文件后,您已经保存并重新启动了Claude。

uv: command not found
→ 安装后关闭并重新打开终端 uv。如果仍然不起作用,请检查 紫外线安装文档 对于您的操作系统。

GROWW_API_KEY not found 或身份验证错误
→ 仔细检查你的 .env.local 文件位于项目根文件夹中(与相同级别 main.py)而且键名拼写完全正确。

端口8000已在使用中
→ 另一个应用程序正在使用该端口。请停止它,或查看项目文档以了解如何更改默认端口。


📜 许可证

MIT许可证——免费使用、修改和分发。

为社区开发 萨加尔·塔芒.


⚠️ 免责声明:这是一个非官方的,社区建立的包装增长贸易API。它不隶属于Groww或得到Groww的认可。交易涉及财务风险。自行决定使用此工具,并在下单前始终验证订单。