AI导哈

Zerodha交易账户查询服务

通过MCP协议查询Zerodha交易账户的服务，支持Claude Code、Claude Desktop、Cursor等MCP兼容工具。

  • by anish5256
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 anish5256/zerodha-mcp

使用说明

Zerodha MCP服务器

通过MCP（模型上下文协议）查询您的Zerodha交易账户。可与Claude Code、Claude Desktop、Cursor和其他MCP兼容的AI工具配合使用。

可用工具

工具 说明
get_account_funds 可用余额和利润
get_portfolio_holdings 长期持有demat
get_open_positions 损益表日内/F&O头寸
get_todays_orders 今天的订单历史
get_current_pnl 合并损益汇总
get_instrument_ltp 任何工具的最后交易价格
get_instrument_ohlc 任何仪器的OHLC数据
get_pnl_summary 日期范围内的历史损益汇总（最多3个月）
get_pnl_heatmap 日期范围内的每日损益明细（最多3个月）

安装

git clone https://github.com/anish5256/zerodha-mcp.git
cd zerodha-mcp
pip install -e .

配置

环境变量

服务器需要以下环境变量进行身份验证：

变量 描述
ZERODHA_USER_ID 您的Zerodha客户端ID（例如。， AB1234)
ZERODHA_PASSWORD 您的Zerodha登录密码
ZERODHA_TOTP_KEY 您的TOTP密钥（32个字符，32个字符串）

获取TOTP密钥

您的TOTP密钥是您在Google Authenticator/Authy中设置2FA时使用的32个字符的代码。它看起来像： ABCD1234EFGH5678IJKL9012MNOP3456

如果尚未保存，请在中重置2FA Zerodha控制台 买一个新的。

按平台设置

克劳德代码（CLI）

添加 ~/.mcp.json:

{
  "mcpServers": {
    "zerodha": {
      "command": "python",
      "args": ["/path/to/zerodha-mcp/server.py"],
      "env": {
        "ZERODHA_USER_ID": "YOUR_USER_ID",
        "ZERODHA_PASSWORD": "YOUR_PASSWORD",
        "ZERODHA_TOTP_KEY": "YOUR_TOTP_SECRET"
      }
    }
  }
}

然后重新启动Claude Code。

克劳德桌面（macOS）

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "zerodha": {
      "command": "python",
      "args": ["/path/to/zerodha-mcp/server.py"],
      "env": {
        "ZERODHA_USER_ID": "YOUR_USER_ID",
        "ZERODHA_PASSWORD": "YOUR_PASSWORD",
        "ZERODHA_TOTP_KEY": "YOUR_TOTP_SECRET"
      }
    }
  }
}

然后重新启动Claude Desktop。

克劳德桌面（Windows）

编辑 %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "zerodha": {
      "command": "python",
      "args": ["C:\\path\\to\\zerodha-mcp\\server.py"],
      "env": {
        "ZERODHA_USER_ID": "YOUR_USER_ID",
        "ZERODHA_PASSWORD": "YOUR_PASSWORD",
        "ZERODHA_TOTP_KEY": "YOUR_TOTP_SECRET"
      }
    }
  }
}

然后重新启动Claude Desktop。

光标

添加到Cursor的MCP设置（设置>MCP）：

{
  "zerodha": {
    "command": "python",
    "args": ["/path/to/zerodha-mcp/server.py"],
    "env": {
      "ZERODHA_USER_ID": "YOUR_USER_ID",
      "ZERODHA_PASSWORD": "YOUR_PASSWORD",
      "ZERODHA_TOTP_KEY": "YOUR_TOTP_SECRET"
    }
  }
}

其他MCP客户端

对于任何兼容MCP的客户端，配置：

  • 命令： python
  • Args： ["/path/to/zerodha-mcp/server.py"]
  • 环境变量：
    • ZERODHA_USER_ID =您的客户ID
    • ZERODHA_PASSWORD =您的密码
    • ZERODHA_TOTP_KEY =您的TOTP秘密

用法示例

配置后，询问您的AI助手：

  • “我目前的投资组合价值是多少？”
  • “显示我的空缺职位”
  • “我今天的损益是多少？”
  • “我有多少可用资金？”
  • “信任的LTP是什么？”
  • “获得OHLC 90-50”
  • “2024年我的F&O利润是多少？”
  • “显示我上个月的每日损益”

安全说明

  • 您的凭据存储在本地MCP配置文件中
  • 凭据从不发送到AI模型，只在服务器端使用
  • 令牌在本地缓存在 zerodha_enctoken.txt 和 zerodha_console_token.txt （忽略）
  • 每个用户都必须在自己的计算机上配置自己的凭据

许可证

麻省理工学院

相关 MCP