Zerodha MCP Integration

Zerodha MCP Integration

site icon
2025.04.09 8
Python金融服务AI 集成交易平台金融服务
Zerodha MCP Integration 是一个将 Zerodha 交易平台与 Claude AI 通过 Multi-Cloud Plugin (MCP) 框架集成的项目,允许用户直接通过 Claude 与 Zerodha 交易账户进行交互。该项目提供了丰富的交易功能,包括股票交易、账户管理、历史数据查询以及互惠基金操作等。
View on GitHub

Overview

基本能力

产品定位

Zerodha MCP Integration 旨在通过 AI 助手 Claude 提供便捷的 Zerodha 交易平台交互体验,简化股票和互惠基金交易流程。

核心功能

  • 认证管理:包括检查认证状态、发起登录流程、获取请求令牌等。
  • 股票/常规交易:查看持仓、获取账户保证金、下单、获取报价、查询历史数据等。
  • 互惠基金操作:查看互惠基金持仓、下单、取消订单、管理 SIP(系统投资计划)等。

适用场景

  • 通过自然语言指令进行股票交易。
  • 查询账户信息和市场数据。
  • 管理互惠基金投资。

工具列表

  • 认证工具check_and_authenticate, initiate_login, 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, place_mf_sip, modify_mf_sip, cancel_mf_sip

常见问题解答

  • 认证问题:删除 .tokens 文件并重启认证流程。
  • 确保 .env 文件中的凭证正确。
  • 检查端口 5000 是否被占用。
  • 查看 Zerodha API 状态页面获取更多帮助。

使用教程

使用依赖

安装必要的 Python 依赖:

uv pip install kiteconnect fastapi uvicorn python-dotenv httpx

安装教程

  1. 创建 Zerodha 开发者账户并获取 API 凭证。
  2. 配置 .env 文件:
KITE_API_KEY=your_api_key_here
KITE_API_SECRET=your_api_secret_here
  1. 安装 MCP 配置:
mcp install main.py

调试方式

  • 确保所有依赖已正确安装。
  • 检查 .env 文件配置是否正确。
  • 运行服务并尝试通过 Claude 发送指令进行交互。

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。