Zerodha MCP-Server

Fragen Sie Ihr Zerodha-Handelskonto über MCP (Model Context Protocol) ab. Funktioniert mit Claude Code, Claude Desktop, Cursor und anderen MCP-kompatiblen KI-Tools.

Verfügbare Tools

Related MCP server: Trade-MCP

Installation

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

Konfiguration

Umgebungsvariablen

Der Server benötigt diese Umgebungsvariablen für die Authentifizierung:

Abrufen Ihres TOTP-Schlüssels

Ihr TOTP-Geheimschlüssel ist der 32-stellige Code, den Sie bei der Einrichtung der 2FA in Google Authenticator/Authy verwendet haben. Er sieht so aus: ABCD1234EFGH5678IJKL9012MNOP3456

Wenn Sie ihn nicht gespeichert haben, setzen Sie die 2FA in der Zerodha Console zurück, um einen neuen zu erhalten.

Einrichtung nach Plattform

Claude Code (CLI)

Fügen Sie dies zu ~/.mcp.json hinzu:

{
  "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"
      }
    }
  }
}

Starten Sie anschließend Claude Code neu.

Claude Desktop (macOS)

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

Starten Sie anschließend Claude Desktop neu.

Claude Desktop (Windows)

Bearbeiten Sie %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"
      }
    }
  }
}

Starten Sie anschließend Claude Desktop neu.

Cursor

Fügen Sie dies zu den MCP-Einstellungen von Cursor hinzu (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"
    }
  }
}

Andere MCP-Clients

Für jeden MCP-kompatiblen Client konfigurieren Sie:

• Befehl: python

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

• Umgebungsvariablen:

  • ZERODHA_USER_ID = Ihre Client-ID

  • ZERODHA_PASSWORD = Ihr Passwort

  • ZERODHA_TOTP_KEY = Ihr TOTP-Geheimschlüssel

Anwendungsbeispiele

Sobald die Konfiguration abgeschlossen ist, fragen Sie Ihren KI-Assistenten:

• "Wie hoch ist mein aktueller Portfoliowert?"

• "Zeige mir meine offenen Positionen"

• "Wie hoch ist meine GuV für heute?"

• "Wie viel Guthaben habe ich zur Verfügung?"

• "Was ist der LTP von RELIANCE?"

• "Hole OHLC für NIFTY 50"

• "Wie hoch war mein F&O-Gewinn im Jahr 2024?"

• "Zeige mir meine tägliche GuV für den letzten Monat"

Sicherheitshinweise

• Ihre Anmeldedaten werden lokal in Ihrer MCP-Konfigurationsdatei gespeichert

• Anmeldedaten werden niemals an das KI-Modell gesendet, sondern nur serverseitig verwendet

• Token werden lokal in zerodha_enctoken.txt und zerodha_console_token.txt zwischengespeichert (gitignored)

• Jeder Benutzer muss seine eigenen Anmeldedaten auf seinem eigenen Computer konfigurieren

Lizenz

MIT