Servidor MCP de Zerodha

Consulta tu cuenta de trading de Zerodha a través de MCP (Model Context Protocol). Funciona con Claude Code, Claude Desktop, Cursor y otras herramientas de IA compatibles con MCP.

Herramientas disponibles

Related MCP server: Trade-MCP

Instalación

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

Configuración

Variables de entorno

El servidor requiere estas variables de entorno para la autenticación:

Obtención de tu clave TOTP

Tu clave secreta TOTP es el código de 32 caracteres que utilizaste al configurar la autenticación de dos factores (2FA) en Google Authenticator/Authy. Se ve así: ABCD1234EFGH5678IJKL9012MNOP3456

Si no la tienes guardada, restablece la 2FA en Zerodha Console para obtener una nueva.

Configuración por plataforma

Claude Code (CLI)

Añade a ~/.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"
      }
    }
  }
}

Luego reinicia Claude Code.

Claude Desktop (macOS)

Edita ~/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"
      }
    }
  }
}

Luego reinicia Claude Desktop.

Claude Desktop (Windows)

Edita %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"
      }
    }
  }
}

Luego reinicia Claude Desktop.

Cursor

Añade a la configuración MCP de 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"
    }
  }
}

Otros clientes MCP

Para cualquier cliente compatible con MCP, configura:

• Comando: python

• Argumentos: ["/path/to/zerodha-mcp/server.py"]

• Variables de entorno:

  • ZERODHA_USER_ID = Tu ID de cliente

  • ZERODHA_PASSWORD = Tu contraseña

  • ZERODHA_TOTP_KEY = Tu secreto TOTP

Ejemplos de uso

Una vez configurado, pregúntale a tu asistente de IA:

• "¿Cuál es el valor actual de mi cartera?"

• "Muéstrame mis posiciones abiertas"

• "¿Cuál es mi P&L de hoy?"

• "¿Cuántos fondos tengo disponibles?"

• "¿Cuál es el LTP de RELIANCE?"

• "Obtén el OHLC para NIFTY 50"

• "¿Cuál fue mi beneficio en F&O en 2024?"

• "Muéstrame mi P&L diario del último mes"

Notas de seguridad

• Tus credenciales se almacenan localmente en tu archivo de configuración MCP

• Las credenciales nunca se envían al modelo de IA, solo se utilizan en el lado del servidor

• Los tokens se almacenan en caché localmente en zerodha_enctoken.txt y zerodha_console_token.txt (ignorados por git)

• Cada usuario debe configurar sus propias credenciales en su propia máquina

Licencia

MIT