Zerodha MCP 集成

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

安装指南

通过 Smithery 安装

要通过 Smithery 自动安装 zerodha-mcp 到 Claude Desktop：

npx -y @smithery/cli install @aptro/zerodha-mcp --client claude

1. 创建 Zerodha 开发者账户

1. 访问 Kite Connect 并注册一个开发者账户。
2. 登录到 developers.kite.trade。

2. 创建新应用

1. 导航至 Kite 开发者仪表板中的“应用”部分。
2. 点击“创建新应用”。
3. 填写所需信息：
   • 应用名称：选择一个描述性的名称（例如，“Claude Zerodha 集成”）。
   • 应用类别：选择“个人”或合适的类别。
   • 重定向 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 账户进行交互：

认证

请检查我是否已登录到我的 Zerodha 账户，并在需要时进行认证。

股票和一般交易

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

共同基金

• 查看共同基金持仓：展示我在 Zerodha 的共同基金持仓。
• 获取共同基金订单：列出我在 Zerodha 的所有共同基金订单。
• 下单购买共同基金：下单购买价值 ₹5000 的共同基金，代号为 INF090I01239。
• 取消共同基金订单：取消我的订单编号为 123456789 的共同基金订单。
• 查看 SIP 细节：展示我在 Zerodha 的所有活跃 SIP。
• 创建新的 SIP：为代号为 INF090I01239 的基金设置每月 SIP，金额为 ₹2000，共 12 期。
• 修改现有 SIP：将我的 SIP 编号为 987654321 的 SIP 更改为每月 ₹3000。
• 取消 SIP：取消我的 SIP 编号为 987654321 的 SIP。
• 浏览可用的共同基金：展示我在 Zerodha 上可获得的共同基金列表。

认证流程

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

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

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

可用的 MCP 工具

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

认证

• 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 的服务器之间。