Zerodha MCP 集成

本项目使用多云插件 (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. 填写所需详细信息：
   • App Name：选择一个描述性名称（例如，“Claude Zerodha Integration”）
   • App Category：选择“Personal”或适当的类别
   • Redirect URL：设置为 http://127.0.0.1:5000/zerodha/auth/redirect
   • Description：简要描述您的应用程序的用途
4. 提交表单以创建您的应用

3. 获取 API 凭据

创建应用后，您将收到：

• API Key（也称为 Consumer Key）
• API Secret（也称为 Consumer Secret）

这些凭据将显示在您应用的详细信息页面上。

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 账户，如果需要，请进行身份验证？)

股票和一般交易

• 检查账户保证金：What are my current margins on Zerodha? (我在 Zerodha 上的当前保证金是多少？)
• 查看投资组合持仓：Show me my current holdings on Zerodha (向我展示我在 Zerodha 上的当前持仓)
• 检查当前仓位：What positions do I currently have open on Zerodha? (我目前在 Zerodha 上有哪些未平仓位？)
• 获取股票代码的报价：What's the current price of RELIANCE and INFY on NSE? (NSE 上 RELIANCE 和 INFY 的当前价格是多少？)
• 下订单：Place a buy order for 10 shares of INFY at market price on NSE (在 NSE 上以市价买入 10 股 INFY)
• 获取历史数据：Can you show me the historical price data for SBIN for the last 30 days? (你能给我展示过去 30 天 SBIN 的历史价格数据吗？)

共同基金

• 查看共同基金持仓：Show me my mutual fund holdings on Zerodha (向我展示我在 Zerodha 上的共同基金持仓)
• 获取共同基金订单：List all my mutual fund orders on Zerodha (列出我在 Zerodha 上的所有共同基金订单)
• 下共同基金订单：Place a buy order for ₹5000 in the mutual fund with symbol INF090I01239 (购买代码为 INF090I01239 的共同基金 5000 卢比)
• 取消共同基金订单：Cancel my mutual fund order with order ID 123456789 (取消我的共同基金订单，订单 ID 为 123456789)
• 查看 SIP 详情：Show all my active SIPs on Zerodha (显示我在 Zerodha 上的所有有效 SIP)
• 创建新的 SIP：Set up a monthly SIP of ₹2000 for the fund with symbol INF090I01239 for 12 installments (为代码为 INF090I01239 的基金设置每月 2000 卢比的 SIP，分 12 期支付)
• 修改现有 SIP：Change my SIP with ID 987654321 to ₹3000 per month (将我的 SIP（ID 为 987654321）更改为每月 3000 卢比)
• 取消 SIP：Cancel my SIP with ID 987654321 (取消我的 SIP，ID 为 987654321)
• 浏览可用的共同基金：Show me a list of available mutual funds on Zerodha (向我展示 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 未被其他应用程序使用
• 对于持续存在的问题，请在 status.zerodha.com 检查 Zerodha 的 API 状态

安全说明

• 您的 Zerodha API 凭据仅存储在您的本地 .env 文件中
• 访问令牌存储在项目目录中的 .tokens 文件中
• 没有凭据传输到 Claude 或任何第三方
• 所有身份验证都直接发生在您和 Zerodha 的服务器之间