Zerodha MCP Server

<p align="center"> <strong>使用Golang编写的与Zerodha数据通信的协议</strong> </p> <p align="center"> <img src="https://raw.githubusercontent.com/sukeesh/sukeesh.github.io/refs/heads/master/assets/img/Zerodha_MCP.png" alt="Zerodha MCP Logo" width="200" /> </p>

概述

Zerodha MCP Server 提供了 Claude MCP（模型完成协议）接口在 Zerodha 交易数据上的实现。这使得 Claude AI 能够直接访问您的 Zerodha 交易账户信息。

预备条件

• Go（版本 1.21 或更高）
• 一个 Zerodha Kite 交易账户
• Claude Desktop 应用
• 从 Kite Connect 开发者门户 获取的 API 凭证

安装

方案 1：使用 Go 安装

go install github.com/sukeesh/zerodha-mcp@latest

方案 2：从源码构建

git clone https://github.com/sukeesh/zerodha-mcp.git
cd zerodha-mcp
go install

二进制文件将安装到您的 GOBIN 目录中，该目录应在您的 PATH 中。

使用 MCP 客户端

GPT 4o mini

https://github.com/user-attachments/assets/849c4aca-0ca2-4aed-a9be-3df135f8a5c5

Claude Sonnet 3.7

<img width="500" alt="Claude 作为 MCP 客户端" src="https://github.com/user-attachments/assets/932ec561-d7b4-4e58-8f1c-1f33b9c99896" />

配置

1. 从 Kite Connect 开发者门户 获取您的 ZERODHA_API_KEY 和 ZERODHA_API_SECRET

2. 在 Kite 开发者门户上设置重定向 URL：

   http://127.0.0.1:5888/auth
   

3. 配置 Claude Desktop：

   • 打开 Claude Desktop → 设置 → 开发者 → 编辑配置
   • 将以下内容添加到您的 claude_desktop_config.json 文件中：

{
  "mcpServers": {
    "zerodha": {
      "command": "<path-to-zerodha-mcp-binary>",
      "env": {
       "ZERODHA_API_KEY": "<api_key>",
       "ZERODHA_API_SECRET": "<api_secret>"
      }
    }
  }
}

4. 重启 Claude Desktop。当提示时，使用您的 Zerodha Kite 凭证进行身份验证。

调试

MCP Server 的日志位于 ~/Library/Logs/Claude

已知问题

当 Claude 桌面关闭时，底层的 MCP Server 不会被终止。

kill -9 $(lsof -t -i:5888)

可用工具

类别	工具	状态	描述
账户信息	get_user_profile	✅	获取基本用户资料信息
	get_user_margins	✅	获取所有用户保证金
	get_user_segment_margins	✅	获取分段用户保证金
投资组合及仓位	get_kite_holdings	✅	获取当前 Zerodha Kite 账户中的持仓
	get_positions	✅	获取当日和净仓位
	get_order_margins	✅	获取特定订单的保证金需求
市场数据	get_ltp	✅	获取特定证券的最新成交价
	get_quote	✅	获取特定证券的详细报价
	get_ohlc	✅	获取开盘、最高、最低、收盘报价
证券	get_instruments	✅	获取 Zerodha 上所有可用证券列表
	get_instruments_by_exchange	✅	获取按交易所筛选的证券
	get_auction_instruments	✅	获取可用于拍卖会话的证券
共同基金	get_mf_instruments	✅	获取所有可用共同基金证券列表
	get_mf_holdings	✅	获取共同基金持仓列表
	get_mf_holdings_info	✅	获取共同基金持仓的详细信息
	get_mf_orders	✅	获取所有共同基金订单列表
	get_mf_order_info	✅	获取特定共同基金订单的详细信息
	get_mf_sip_info	✅	获取共同基金 SIP 的信息
	get_mf_allotted_isins	✅	获取分配的共同基金 ISIN

使用方法

设置完成后，您可以通过 Claude 直接与您的 Zerodha 账户数据交互。例如：

• "显示我当前的投资组合持仓"
• "我的当前保证金可用性是多少？"
• "给我最新的 RELIANCE 价格"
• "显示我有利润和亏损的开放仓位"

限制

• 只支持读取操作；尚未提供交易功能
• 认证令牌每天过期，需要重新登录