项目简介

Zerodha MCP Plugin 是一个基于 Model Context Protocol (MCP) 框架的服务器端实现,旨在将 Zerodha 股票交易平台的功能集成到支持 MCP 协议的 LLM 客户端 (如 Claude) 中。通过此插件,用户可以使用自然语言指令,让 LLM 客户端安全地访问和操作其 Zerodha 交易账户,实现股票和 mutual fund 的交易、查询等功能。

主要功能点

  • 身份验证: 安全地连接和验证 Zerodha 账户。
  • 股票交易: 查询股票行情、下单、查看持仓和订单等。
  • Mutual Fund 交易: 查询 Mutual Fund 信息、下单、管理 SIP 等。
  • 账户管理: 查看账户资金和保证金信息。

安装步骤

  1. 创建 Zerodha 开发者账户: 访问 Kite Connect 并注册开发者账户。
  2. 创建应用: 在 Kite 开发者后台创建新应用,填写应用信息,重定向 URL 设置为 'http://127.0.0.1:5000/zerodha/auth/redirect'。
  3. 获取 API 凭证: 获取应用的 API Key (Consumer Key)API Secret (Consumer Secret)
  4. 配置环境变量: 在项目根目录下创建 '.env' 文件,并添加 API 凭证:
    KITE_API_KEY=your_api_key_here
    KITE_API_SECRET=your_api_secret_here
  5. 安装依赖: 确保已安装所有依赖:
    pip install kiteconnect fastapi uvicorn python-dotenv httpx
  6. 安装 MCP 配置: 在 Claude 桌面应用中安装 MCP 配置 (使用仓库 README.md 中的命令 'mcp install main.py' 或手动配置)。

服务器配置

要将此 MCP 服务器添加到 MCP 客户端,您需要配置以下信息。以下是 Claude 桌面应用所需的 MCP 服务器配置 JSON 示例:

{
  "serverName": "zerodha",
  "command": "python",
  "args": ["main.py"]
}
  • 'serverName': 服务器名称,可以自定义,例如 "zerodha"。
  • 'command': 启动服务器的命令,通常为 'python' 或 'python3',取决于您的 Python 环境。
  • 'args': 启动服务器的参数,这里是 '["main.py"]',指向服务器主程序文件。

请确保在 MCP 客户端中正确配置以上信息,以便客户端能够连接到 Zerodha MCP 服务器。您可能需要在运行 MCP 客户端的机器上先安装 Python 环境和项目依赖。

基本使用方法

安装并配置完成后,在支持 MCP 协议的 LLM 客户端 (如 Claude) 中,即可使用自然语言指令与 Zerodha 账户进行交互。例如:

  • 查询账户保证金: 'What are my current margins on Zerodha?'
  • 查看股票持仓: 'Show me my current holdings on Zerodha'
  • 下单买入股票: 'Place a buy order for 10 shares of INFY at market price on NSE'
  • 查询 mutual fund 持仓: 'Show me my mutual fund holdings on Zerodha'

更多指令和功能请参考仓库 README.md 中的 "Usage" 部分。

信息

分类

商业系统