Zerodha MCP Server

Запрашивайте данные своего торгового счета Zerodha через MCP (Model Context Protocol). Работает с Claude Code, Claude Desktop, Cursor и другими инструментами ИИ, совместимыми с MCP.

Доступные инструменты

Related MCP server: Trade-MCP

Установка

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

Конфигурация

Переменные окружения

Сервер требует следующие переменные окружения для аутентификации:

Получение ключа TOTP

Ваш секретный ключ TOTP — это 32-символьный код, который вы использовали при настройке 2FA в Google Authenticator/Authy. Он выглядит так: ABCD1234EFGH5678IJKL9012MNOP3456

Если он у вас не сохранен, сбросьте 2FA в Zerodha Console, чтобы получить новый.

Настройка по платформам

Claude Code (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.

Claude Desktop (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.

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 в Cursor (Settings > 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

• Аргументы: ["/path/to/zerodha-mcp/server.py"]

• Переменные окружения:

  • ZERODHA_USER_ID = Ваш ID клиента

  • ZERODHA_PASSWORD = Ваш пароль

  • ZERODHA_TOTP_KEY = Ваш секретный ключ TOTP

Примеры использования

После настройки спросите своего ИИ-ассистента:

• "Какова текущая стоимость моего портфеля?"

• "Покажи мои открытые позиции"

• "Какой у меня P&L за сегодня?"

• "Сколько у меня доступных средств?"

• "Какова последняя цена сделки (LTP) для RELIANCE?"

• "Получи OHLC для NIFTY 50"

• "Какая была моя прибыль по F&O в 2024 году?"

• "Покажи мой ежедневный P&L за прошлый месяц"

Примечания по безопасности

• Ваши учетные данные хранятся локально в файле конфигурации MCP

• Учетные данные никогда не отправляются в ИИ-модель, они используются только на стороне сервера

• Токены кэшируются локально в zerodha_enctoken.txt и zerodha_console_token.txt (добавлены в gitignore)

• Каждый пользователь должен настроить свои учетные данные на своем компьютере

Лицензия

MIT