🚀 Zerodha Trading Agent (MCP x Bun.js)

🚀 Zerodha 交易 Agent（MCP x Bun.js）

这是一个使用以下技术构建的智能股票交易 Agent：

• Bun.js（快速的 JavaScript 运行时）
• Zerodha Kite Connect API
• Claude MCP 服务集成

该 Agent 可让你下单交易、根据触发条件自动买入/卖出股票，并在未来规划中利用历史数据和实时新闻预测股票走势。

---

📋 功能

• 🔥 通过 MCP Agent 自动下达买入和卖出订单
• 🛡️ 使用 Kite Connect 安全地进行身份验证
• 🔄 定期自动刷新访问令牌
• 🎯 （即将推出） 类似 Smart GTT 的观察列表买卖功能
• 🧠 （即将推出） 利用图表和新闻分析进行股票未来走势预测
• ⚡ 使用 Bun.js 构建，运行速度极快
• 🎯 完全兼容 Claude Toolchain / MCP Agents

---

📂 项目结构

zerodha-trade/
├── index.ts          # MCP Server setup, defines trading tools
├── trade.ts          # Trading logic: place order, generate session
├── refreshToken.ts   # Refreshes access token using request_token
├── login.ts          # (One time) Generate new access token
├── tokenStore.json   # Stores API key, secret, access token
├── watchlist.json    # (Coming soon) GTT trigger rules
├── README.md         # Project documentation

---

⚙️ 设置说明

1. 安装依赖

bun install

（请确保已安装 Bun.js：）

curl -fsSL https://bun.sh/install | bash

---

2. 配置 API 凭据

更新 tokenStore.json，填写：

{
  "apiKey": "YOUR_KITE_API_KEY",
  "apiSecret": "YOUR_KITE_API_SECRET",
  "accessToken": "YOUR_ACCESS_TOKEN"
}

如果你还没有 accessToken，请运行：

bun login.ts

手动生成一个。

---

3. 运行 Agent 服务

bun index.ts

✅ 这将会：

• 每 24 小时自动刷新访问令牌
• 通过 MCP 服务向 Claude Agent 提供交易功能
• 在 http://localhost:3000 上运行服务

---

4. 在本地使用 HTTPS（通过 ngrok）

由于 Kite Connect 要求使用 HTTPS URL，你可以使用 ngrok 安全地为本地服务创建隧道。

brew install ngrok   # Install ngrok (if not already installed)
ngrok http 3000      # Expose port 3000 via HTTPS

运行后，你会获得一个公开的 HTTPS URL，例如 https://abc1234.ngrok.io。创建 Kite Connect 应用时，请将此 URL 用作重定向 URL。

---

5. 创建 Kite Connect 应用（获取 API Key/Secret）

1. 前往 Kite Developer Console
2. 点击创建新应用
3. 填写：
   • 应用名称：（任意有意义的名称）
   • 重定向 URL：（粘贴你的 https://xyz.ngrok.io URL）
   • 回调 URL：（相同或另一个 ngrok HTTPS URL）
   • 产品： Kite Connect
   • 交易所： NSE、BSE 等
4. 创建完成后，你将获得 API Key 和 API Secret
5. 相应地更新 tokenStore.json

---

🚀 MCP 服务配置示例

{
  "mcpServers": {
    "zerodha-trade": {
      "command": "/Users/vamsi/.bun/bin/bun",
      "args": [
        "--directory",
        "/Users/vamsi/Projects/zerodha-trade",
        "index.ts"
      ]
    }
  }
}

---

🛠️ 后续增强（路线图）

• 🔔 Smart GTT 智能触发系统：价格达到目标时买入/卖出
• 📈 股票未来走势预测 Agent（使用历史价格和实时新闻）
• 📊 面向 Nifty50 等 ETF 的自动 SIP 机器人
• 📬 订单成功执行时发送 Telegram/Slack 提醒
• 📉 自动为投资组合持仓设置止损

---

🤖 工作原理（概览）

1. MCP Agent 请求 buyStock(symbol, quantity) 或 sellStock(symbol, quantity)
2. Agent 服务使用 Kite Connect API 下单
3. 每天自动刷新访问令牌
4. （即将推出） 后台服务监控价格，以自动触发类似 GTT 的订单
5. （即将推出） 通过新闻和图表分析预测股票走势

---

✨ 致谢

• Zerodha Kite Connect API
• Bun.js
• Claude Model Context Protocol
• Zerodha Developer Community

---