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

2. 安装依赖项：

npm install

3. 在根目录创建一个.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 Desktop 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用于模式验证

贡献

欢迎贡献！请随时提交Pull Request。

许可证

本项目采用MIT许可证——详情见LICENSE文件。

免责声明

本项目仅用于教育目的。金融市场交易存在重大风险。请务必自行研究并负责任地进行交易。