Zerodha 交易助手 MCP 插件

关键词

交易股票基金Zerodha投资

项目简介

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" 部分。

服务器信息

访问项目