Zerodha交易数据协议

Zerodha MCP Server是一个用Golang编写的协议,用于与Zerodha交易数据进行通信,允许Claude AI直接访问您的Zerodha交易账户信息。

  • by sukeesh
  • Go
  • 本地部署
  • 11 星标
  • 更新于
在 GitHub 查看 sukeesh/zerodha-mcp-go

使用说明

Zerodha MCP服务器

Protocol to communicate with your Zerodha data written in Golang

概述

Zerodha MCP服务器为Zerodha交易数据提供了Claude MCP(模型完成协议)接口的实现。这允许Claude AI直接访问您的Zerodha交易账户信息。

先决条件

安装

选项1:使用Go Install

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

克劳德十四行诗3.7

配置

  1. 得到你的 ZERODHA_API_KEY 和 ZERODHA_API_SECRET 从 Kite Connect开发者门户

  2. 在Kite开发者门户中设置重定向URL:

    http://127.0.0.1:5888/auth
    
  3. 配置Claude桌面:

    • 打开克劳德桌面→ 设置→ 开发者→ 编辑配置
    • 将以下内容添加到您的 claude_desktop_config.json:
{
  "mcpServers": {
    "zerodha": {
      "command": "<path-to-zerodha-mcp-binary>",
      "env": {
       "ZERODHA_API_KEY": "<api_key>",
       "ZERODHA_API_SECRET": "<api_secret>"
      }
    }
  }
}
  1. 重新启动克劳德桌面。出现提示时,使用您的Zerodha Kite凭据进行身份验证。

调试

MCP服务器的日志可在以下网址获得 ~/Library/Logs/Claude

已知Bug

当Claude桌面关闭时,底层MCP服务器不会被杀死。

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的最新价格”
  • “显示我在损益表的未平仓头寸”

局限性

  • 仅支持读取操作;交易尚未可用
  • 身份验证令牌每天过期,需要重新登录