股票交易接口服务

一个连接AI模型与Zerodha交易平台的协议服务器,提供交易执行、持仓查看和投资组合管理的标准化接口。

  • by 0xprajapati
  • TypeScript
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 shubhamprajapati7748/zerodha-trade-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许可证获得许可-有关详细信息,请参阅许可证文件。

免责声明

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