Zerodha MCP Server

Zerodha MCP 服务

使用 Golang 编写的 Zerodha 数据通信协议

概述

Zerodha MCP 服务为 Zerodha 交易数据提供了 Claude MCP（Model Completion Protocol）接口的实现。借此，Claude AI 可以直接访问您的 Zerodha 交易账户信息。

前提条件

• Go（版本 1.21 或更高）
• Zerodha Kite 交易账户
• Claude Desktop App
• 来自 Kite Connect 开发者门户的 API 凭据

安装

选项 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

Claude Sonnet 3.7

配置

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

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

   http://127.0.0.1:5888/auth
   

3. 配置 Claude Desktop：

   • 打开 Claude Desktop → Settings → Developer → Edit Config
   • 将以下内容添加到您的 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 服务的日志位于 ~/Library/Logs/Claude

已知问题

关闭 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 的最新价格”
• “显示我的未平仓头寸及盈亏”

限制

• 仅支持读取操作；暂不支持交易
• 身份验证令牌每天过期，需要重新登录