Zerodha 交易 MCP
模型上下文协议 (MCP) 服务器，使 AI 模型能够与 Zerodha 交易平台交互。该项目提供了一套工具，用于通过标准化界面在 Zerodha 上执行交易、查看投资组合和管理头寸。
特征
- 🔐 使用 Zerodha API 进行安全身份验证
- 📊 查看投资组合持股
- 📈 查看空缺职位
- 💹下达买入/卖出订单
- 👤 访问用户个人资料信息
先决条件
- Node.js（v14 或更高版本）
- Zerodha交易账户
- 来自 Zerodha 的 API 凭证
安装
- 克隆存储库：
git clone https://github.com/shubhamprajapati7748/zerodha-trade-mcp.git
cd zerodha-trade-mcp
- 安装依赖项：
- 使用您的 Zerodha 凭据在根目录中创建一个
.env文件：
KITE_API_KEY=your_api_key
KITE_SECRET_KEY=your_secret_key
REQUEST_TOKEN=your_request_token
ACCESS_TOKEN=your_access_token
Claude Desktop MCP 配置
要将此 MCP 服务器与 Claude Desktop 配合使用，您需要配置 mcp 服务器的详细信息。设置方法如下：
- 在项目根目录中打开
claude_desktop_config.json - 添加以下配置：
{
"mcpServers": {
"tradeStocks": {
"command": "/opt/homebrew/bin/bun",
"args": [
"/path/to/your/index.ts"
],
"env": {
"KITE_API_KEY": "your_api_key",
"KITE_SECRET_KEY": "your_secret_key",
"REQUEST_TOKEN": "your_request_token",
"ACCESS_TOKEN": "your_access_token"
}
}
}
}
请确保：
- 更新
index.ts文件的路径 - 用您的实际 Zerodha 凭据替换环境变量
用法
MCP 服务器提供以下工具：
获取个人资料
从 Zerodha 检索用户的个人资料信息。
购买股票
buy-stock {stock: string, quantity: number}
针对指定股票和数量下达购买订单。
出售股票
sell-stock {stock: string, quantity: number}
针对指定股票和数量下达卖出订单。
显示投资组合
显示用户的完整投资组合。
显示职位
显示用户的未平仓头寸。
发展
该项目采用以下方式构建：
- TypeScript
- KiteConnect API
- 模型上下文协议 (MCP) SDK
- Zod 用于模式验证
贡献
欢迎贡献代码！欢迎提交 Pull 请求。
执照
该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。
免责声明
本项目仅供教育用途。金融市场交易存在重大风险。请务必自行研究并负责任地进行交易。