Zerodha Trading MCP

Zerodha交易MCP

模型上下文协议（MCP）服务器，使AI模型能够与Zerodha交易平台进行交互。该项目提供了一套工具，用于通过标准化界面在Zerodha上执行交易、查看投资组合和管理头寸。

特性

• 🔐 使用Zerodha API进行安全身份验证
• 📊 查看投资组合持有量
• 📈 检查空缺职位
• 💹 下达买入/卖出订单
• 👤 访问用户配置文件信息

先决条件

• Node.js（v14或更高版本）
• Zerodha交易账户
• 来自Zerodha的API证书

安装

1. 克隆存储库：

git clone https://github.com/shubhamprajapati7748/zerodha-trade-mcp.git
cd zerodha-trade-mcp

1. 安装依赖项：

npm install

1. 创建一个 .env 根目录中的文件，其中包含您的Zerodha凭据：

KITE_API_KEY=your_api_key
KITE_SECRET_KEY=your_secret_key
REQUEST_TOKEN=your_request_token
ACCESS_TOKEN=your_access_token

Claude桌面MCP配置

要将此MCP服务器与Claude Desktop一起使用，您需要配置MCP服务器详细信息。以下是如何设置它：

1. 打开 claude_desktop_config.json 在项目根目录中
2. 添加以下配置：

{
  "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服务器提供以下工具：

获取个人资料

get-profile

从Zerodha检索用户的配置文件信息。

购买股票

buy-stock {stock: string, quantity: number}

为指定的库存和数量下采购订单。

出售股票

sell-stock {stock: string, quantity: number}

为指定的库存和数量下销售订单。

展示作品集

show-portfolio

显示用户的完整投资组合持有量。

显示位置

show-positions

显示用户的未平仓头寸。

发展

该项目是使用以下方式构建的：

• TypeScript
• KiteConnect API
• 模型上下文协议（MCP）SDK
• Zod用于模式验证

贡献

欢迎投稿！请随时提交拉取请求。

许可证

此项目根据MIT许可证获得许可-有关详细信息，请参阅许可证文件。

免责声明

本项目仅用于教育目的。金融市场交易具有重大风险。始终负责任地进行自己的研究和交易。