Zerodha MCP 集成

此项目通过 Multi-Cloud Plugin (MCP) 框架将 Zerodha 交易平台与 Claude AI 集成，使您能够直接通过 Claude 与您的 Zerodha 交易账户进行交互。

设置说明

1. 创建 Zerodha 开发者账户

1. 前往 Kite Connect 并注册一个开发者账户
2. 登录您的账户 developers.kite.trade

2. 创建新应用

1. 在 Kite 开发者仪表板中导航到“Apps”部分
2. 点击“Create a new app”（创建新应用）
3. 填写所需信息：
   • 应用名称：选择一个描述性名称（例如，“Claude Zerodha Integration”）
   • 应用类别：选择“Personal”或适当类别
   • 重定向 URL：设置为 http://127.0.0.1:5000/zerodha/auth/redirect
   • 描述：简要描述您的应用程序的目的
4. 提交表单以创建您的应用

3. 获取 API 凭证

创建应用后，您将收到：

• API 密钥（也称为消费者密钥）
• API 密码（也称为消费者密码）

这些凭证将在您的应用详情页面上显示。

4. 配置环境变量

1. 在此项目的根目录中创建一个 .env 文件
2. 将您的 API 凭证添加到文件中：

KITE_API_KEY=your_api_key_here
KITE_API_SECRET=your_api_secret_here

将 your_api_key_here 和 your_api_secret_here 替换为步骤 3 中的实际凭证。

5. 安装依赖项

确保已安装所有必需的依赖项：

uv pip install kiteconnect fastapi uvicorn python-dotenv httpx

6. 在您的 Claude 桌面应用上安装 MCP 配置

在您的 Claude 桌面应用上安装 MCP 配置：

mcp install main.py

该命令将 Zerodha 插件注册到 Claude，使所有交易功能对 AI 可用。

使用方法

设置完成后，您可以使用以下功能通过 Claude 与您的 Zerodha 账户进行交互：

身份验证

Can you please check if I'm logged into my Zerodha account and authenticate if needed?

股票和一般交易

• 检查账户保证金：我在 Zerodha 的当前保证金是多少？
• 查看投资组合持有情况：显示我在 Zerodha 上的当前持有情况
• 检查当前仓位：我在 Zerodha 上目前有哪些仓位是开放的？
• 获取股票代码报价：NSE 上 RELIANCE 和 INFY 的当前价格是多少？
• 下订单：在 NSE 上以市价买入 10 股 INFY
• 获取历史数据：你能给我展示 SBIN 过去 30 天的历史价格数据吗？

共同基金

• 查看共同基金持仓：Show me my mutual fund holdings on Zerodha
• 获取共同基金订单：List all my mutual fund orders on Zerodha
• 下达共同基金订单：Place a buy order for ₹5000 in the mutual fund with symbol INF090I01239
• 取消共同基金订单：Cancel my mutual fund order with order ID 123456789
• 查看SIP详情：Show all my active SIPs on Zerodha
• 创建新的SIP：Set up a monthly SIP of ₹2000 for the fund with symbol INF090I01239 for 12 installments
• 修改现有的SIP：Change my SIP with ID 987654321 to ₹3000 per month
• 取消SIP：Cancel my SIP with ID 987654321
• 浏览可用的共同基金：Show me a list of available mutual funds on Zerodha

认证流程

首次使用任何Zerodha功能时，Claude将：

1. 在端口5000上启动本地服务器
2. 打开浏览器窗口进行Zerodha登录
3. 成功登录后，存储访问令牌以供后续会话使用

您的会话将在令牌过期前保持有效（通常为24小时）。当令牌过期时，Claude将自动重新启动登录流程。

可用的MCP工具

此插件提供了以下Claude可以使用的MCP工具：

认证

• check_and_authenticate - 验证认证状态并在需要时启动登录
• initiate_login - 启动Zerodha登录流程
• get_request_token - 登录后检索请求令牌

股票/通用交易

• get_holdings - 检索投资组合持仓
• get_positions - 获取当前仓位
• get_margins - 检索账户保证金
• place_order - 下达交易订单
• get_quote - 获取指定符号的报价
• get_historical_data - 检索历史价格数据

共同基金

• get_mf_orders - 检索共同基金订单
• place_mf_order - 下达共同基金订单
• cancel_mf_order - 取消共同基金订单
• get_mf_instruments - 获取可用的共同基金工具
• get_mf_holdings - 检索共同基金持仓
• get_mf_sips - 获取活跃的SIP
• place_mf_sip - 创建新的SIP
• modify_mf_sip - 修改现有SIP
• cancel_mf_sip - 取消SIP

故障排除

• 如果遇到认证问题，请尝试删除.tokens文件并重新开始认证过程
• 确保.env文件中的Zerodha凭据是正确的
• 确保端口5000未被其他应用程序占用
• 对于持续存在的问题，请检查Zerodha的API状态 status.zerodha.com

安全须知

• 您的Zerodha API凭据仅存储在本地的.env文件中
• 访问令牌存储在项目目录中的.tokens文件里
• 凭据不会传输给Claude或任何第三方
• 所有认证直接发生在您与Zerodha服务器之间