AI导哈

Zerodha交易集成工具

通过Model Context Protocol (MCP)将Zerodha交易平台与Claude AI无缝集成，实现通过自然对话进行股票交易、管理共同基金和监控投资组合。

  • by hityaasdfg
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 hityaasdfg/MCP_server

使用说明

Zerodha MCP（Margin Calculator Program，保证金计算器程序）集成

利用模型上下文协议（MCP），将Zerodha交易平台与Claude AI无缝集成。通过与Claude进行自然对话，即可交易股票、管理共同基金并监控您的投资组合。

✨ 特点

股票交易

  • 📊 实时投资组合和持仓跟踪
  • 💰 实时保证金和余额查询
  • 📈 实时市场报价和历史数据
  • 🎯 快速下单与管理

共同基金（或称为互惠基金）

  • 🏦 完整的共同基金投资组合概览
  • 📅 定投计划（Systematic Investment Plan，简称SIP）管理
  • 💸 一键式共同基金订单
  • 🔍 浏览可用资金

🚀 快速入门

选项1：自动安装（推荐）

通过（某种方式）自动安装 “Smithery”可以翻译为“铁匠铺”或“锻造工坊”。这个词源自英语，其中“Smith”通常指的是铁匠或锻造工匠，“ery”则表示某种职业或活动的场所。因此，“Smithery”指的是进行铁匠工作或锻造活动的地方：

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

选项2：手动安装

按照以下详细的设置步骤进行操作。

📋 先决条件

  • 已安装Node.js和npm
  • Python 3.8 或更高版本
  • 一个Zerodha交易账户
  • Claude 桌面应用程序

🔧 安装指南

步骤1：创建Zerodha开发者账户

  1. 参观 风筝连接（或“风筝互联”，根据上下文，“Kite Connect”可能指的是某种与风筝相关的连接服务或应用，这里提供了两种可能的翻译，具体使用哪种取决于实际语境） 并进行注册
  2. 登录到您的 开发者仪表板

步骤2：注册您的应用程序

  1. 导航至 应用程序 在您的仪表盘中的部分
  2. 点击 “创建一个新应用”
  3. 填写申请详情：
    • 应用名称: Claude Zerodha Integration （或您喜欢的名称）
    • 应用类别: Personal
    • 重定向URL： http://127.0.0.1:5000/zerodha/auth/redirect
    • 描述您整合工作的简要描述
  4. 提交以创建您的应用

步骤3：获取API凭证

应用创建后，您将收到：

  • API密钥 （消费者密钥）
  • API密钥 (消费者密钥)

请确保这些凭证的安全——您在下一步中会需要它们。

步骤4：配置环境

  1. 创建一个 .env 在你的项目根目录中创建文件
  2. 添加您的凭据：
KITE_API_KEY=your_api_key_here
KITE_API_SECRET=your_api_secret_here

重要的将占位符值替换为您实际的凭据。

第五步：安装依赖项

安装所需的Python包：

uv pip install kiteconnect fastapi uvicorn python-dotenv httpx

步骤6：配置Claude桌面版

将MCP服务器注册到Claude：

mcp install main.py

这使得所有Zerodha的交易功能都可以通过Claude使用。

💬 使用示例

配置完成后，您可以通过Claude自然地与您的Zerodha账户进行交互：

认证

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

投资组合与账户管理

What are my current margins?
Show me my holdings
What positions do I have open?

市场数据与交易

What's the current price of RELIANCE and INFY?
Place a buy order for 10 shares of TCS at market price
Show me SBIN's price history for the last 30 days

共同基金（或基金）

Show my mutual fund holdings
List all my mutual fund orders
Buy ₹5000 worth of INF090I01239
Show all my active SIPs
Set up a monthly SIP of ₹2000 for INF090I01239 for 12 months
Cancel my SIP with ID 987654321

🔐 认证流程

首次使用时：

  1. 克劳德启动了一个本地认证服务器（端口5000）
  2. 您的浏览器打开的是Zerodha的登录页面
  3. 成功登录后，访问令牌将被本地存储
  4. 令牌有效期约为24小时
  5. 当令牌过期时，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 - 下达市场订单（MF订单）
  • cancel_mf_order - 取消市场订单（MF orders）
  • get_mf_instruments - 浏览可用资金
  • get_mf_holdings - 查看MF投资组合
  • get_mf_sips - 列出活跃的SIP（软件定义网络/会话发起协议实例）
  • place_mf_sip - 创建新的SIP（会话初始协议）
  • modify_mf_sip - 修改现有的SIP（会话初始协议）
  • cancel_mf_sip - 取消SIP（系统集成平台/定时投资计划/根据上下文可能指其他具体含义）

🐛 故障排除

认证问题

  • 删除 .tokens 文件并重新认证
  • 验证您的 .env 凭据正确
  • 确保您的Kite应用中的重定向URL与以下内容匹配： http://127.0.0.1:5000/zerodha/auth/redirect

连接问题

API 错误

  • 确认您的Zerodha开发者账户处于活跃状态
  • 检查您的API订阅是否已过期
  • 检查速率限制 Kite Connect 文档

🔒 安全与隐私

您的数据是安全的:

  • API凭据仅存储在您的本地 .env 文件
  • 保存在本地的访问令牌 .tokens 文件
  • 不向Claude或第三方传输任何凭证信息
  • 与Zerodha的安全服务器进行直接认证
  • 所有交易操作均通过Zerodha的官方API进行

最佳实践:

  • 永不承诺 .env 或者 .tokens 文件提交到版本控制系统
  • 请保密您的API凭证
  • 定期在Kite Connect上检查您的API应用权限
  • 为您的Zerodha账户设置强密码

📚 额外资源

📄 许可证

[在此添加您的许可证信息]

🤝 贡献（或“参与贡献”）

欢迎贡献！请随时提交问题或拉取请求。

⚠️ 免责声明

这是一个非官方集成。使用前请自行承担风险。务必在执行订单前进行验证。开发者对因使用此集成而产生的任何交易损失或问题不承担责任。

相关 MCP