etoro-mcp

Read-only server Remote-MCP-Server, der eToro-Portfolio-data (Positionen, P&L, Kontostände, Watchlists, Historie geschlossener Trades) als Tools bereitstellt, sodass er als benutzerdefinierter Connector in Claude registriert werden kann (claude.ai-Chat, nicht nur in einem Editor). Läuft auf Cloudflare Workers über Streamable HTTP.

Dies ist ein persönliches Einzelbenutzer-Tool. Es platziert, ändert oder schließt niemals einen Trade – es stellt nur GET-Anfragen an die eToro-API.

Voraussetzungen

• Node.js (aktuelle LTS-Version)

• Ein Cloudflare-Konto (für wranger dev und die spätere Bereitstellung)

• eToro-API-Anmeldedaten (x-api-key / x-user-key) von api-portal.etoro.com

Abhängigkeiten installieren:

npm install

Über Wrangler

Dieses Projekt wird auf Cloudflare Workers bereitgestellt, und Wranger ist Cloudflares offizielle CLI zum Erstellen, Testen und Bereitstellen von Workers. Es ist bereits als devDependency aufgeführt, daher bringt npm install es automatisch mit – keine separate Installation erforderlich. Verwendet wird es über npx wrangler ... oder das untenstehende Skript npm run dev. Relevante Befehle:

• wrangler dev — startet den Server lokal und simuliert die Workers-Laufzeit (das ist es, was npm run dev aufruft).

• wrangler deploy — veröffentlicht den Code auf dem Edge-Netzwerk von Cloudflare unter einer echten öffentlichen URL.

• wrangler secret put <name> — lädt ein Secret (z. B. deinen eToro-API-Key oder das Bearer-Token des Connectors) sicher auf den bereitgestellten Worker hoch, ohne es jemals in das Repository zu committen.

• wrangler.toml — die Workers-Konfiguration dieses Repos (build/name/routes).

Bevor wrangler deploy oder wrangler secret put funktioniert, melde dich einmalig an:

wrangler login

Related MCP server: eToro Portfolio Connector

Lokale Entwicklung (wrangler dev)

1. Kopiere die Datei für die Beispiel-Umgebungsvariablen und fülle echte Werte ein:

   cp .dev.vars.example .dev.vars

2. Lege in .dev.vars folgendes fest:

   • ETORO_API_KEY / ETORO_USER_KEY — deine eToro-API-Anmeldedaten.

   • CONNECTOR_AUTH_TOKEN — ein geheimes Bearer-Token, das den /mcp-Endpunkt dieses Connectors schützt (unabhängig von den obigen eToro-Anmeldedaten). Erzeuge eines mit:

     openssl rand -hex 32

   .dev.vars ist in der .gitignore enthalten — niemals committen.

3. Starte den lokalen Workers-Entwicklungsserver:

   npm run dev

4. Jede Anfrage auf /mcp muss das Bearer-Token enthalten:

   Authorization: Bearer <CONNECTOR_AUTH_TOKEN from .dev.vars>

   Anfragen ohne diesen Header oder mit falschem Token erhalten eine 401. Wenn CONNECTOR_AUTH_TOKEN überhaupt nicht gesetzt ist, verweigert der Server nach dem Fail-closed-Prinzip jede Anfrage, statt unauthentifizierten Zugriff zu erlauben.

Tests ausführen

npm test        # unit tests (node:test)
npm run typecheck

Bereitstellen und als Claude-Connector registrieren

Bereitstellung und Connector-Registrierung sind manuelle Schritte, die vom Betreiber durchgeführt werden (nicht Bestandteil der Automation dieses Repos):

1. Setze die Secrets auf dem bereitgestellten Worker (niemals ins Repository committen):

   wrangler secret put ETORO_API_KEY
   wrangler secret put ETORO_USER_KEY
   wrangler secret put CONNECTOR_AUTH_TOKEN

2. Stellen bereit:

   wrangler deploy

   Dies veröffentlicht den Worker und gibt dessen *.workers.dev-URL aus (oder eine benutzerdefinierte Route, falls konfiguriert).

3. Als benutzerdefinierten Connector in Claude registrieren:

   • Gehe in claude.ai zu Settings → Connectors → Add custom connector.

   • Gib die /mcp-URL des bereitgestellten Workers ein.

   • Schließe den Authentifizierungsschritt des Connectors ab und verwende denselben CONNECTOR_AUTH_TOKEN-Wert, der oben über wrangler secret put gesetzt wurde.

4. Ende-zu-Ende-Prüfung: Stelle Claude in einem normalen Chat eine echte Portfolio-Frage (z. B. „Wie ist mein eToro-Portfolio-P&L gerade?“) und bestätige, dass er das richtige Tool aufruft und Live-Daten zurückgibt.