项目简介
Zerodha MCP Plugin 是一个基于 Model Context Protocol (MCP) 框架的服务器端实现,旨在将 Zerodha 股票交易平台的功能集成到支持 MCP 协议的 LLM 客户端 (如 Claude) 中。通过此插件,用户可以使用自然语言指令,让 LLM 客户端安全地访问和操作其 Zerodha 交易账户,实现股票和 mutual fund 的交易、查询等功能。
主要功能点
- 身份验证: 安全地连接和验证 Zerodha 账户。
- 股票交易: 查询股票行情、下单、查看持仓和订单等。
- Mutual Fund 交易: 查询 Mutual Fund 信息、下单、管理 SIP 等。
- 账户管理: 查看账户资金和保证金信息。
安装步骤
- 创建 Zerodha 开发者账户: 访问 Kite Connect 并注册开发者账户。
- 创建应用: 在 Kite 开发者后台创建新应用,填写应用信息,重定向 URL 设置为 'http://127.0.0.1:5000/zerodha/auth/redirect'。
- 获取 API 凭证: 获取应用的 API Key (Consumer Key) 和 API Secret (Consumer Secret)。
- 配置环境变量: 在项目根目录下创建 '.env' 文件,并添加 API 凭证:
KITE_API_KEY=your_api_key_here KITE_API_SECRET=your_api_secret_here - 安装依赖: 确保已安装所有依赖:
pip install kiteconnect fastapi uvicorn python-dotenv httpx - 安装 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" 部分。
信息
分类
商业系统