MCP Bitpanda Server

Ein Model Context Protocol (MCP)-Server, der Tools für die Interaktion mit der Bitpanda-API bereitstellt. Dieser Server ermöglicht den programmgesteuerten Zugriff auf Bitpanda-Funktionen wie Trades, Wallets und Transaktionen über das MCP-Protokoll.

Voraussetzungen

• Node.js (v18 oder höher empfohlen)

• npm (wird mit Node.js geliefert)

• Ein Bitpanda-API-Schlüssel (festgelegt als Umgebungsvariable BITPANDA_API_KEY )

• (Optional) MCP-kompatibler Client oder Runner (z. B. VSCode-Erweiterung, CLI)

Aufstellen

1. Klonen Sie das Repository oder stellen Sie sicher, dass Sie sich im Projektverzeichnis befinden.

2. Installieren Sie Abhängigkeiten:

   npm install

3. Erstellen Sie den Server:

   npm run build

   Dadurch wird ein build -Verzeichnis mit dem kompilierten JavaScript-Code erstellt.

Ausführen des Servers

• Direkt:

  node build/index.js

  oder, wenn Sie ein Startskript haben:

  npm run start

• Über MCP-Runner: Konfigurieren Sie Ihren MCP-Client so, dass der Server über stdio-Transport ausgeführt wird. Beispiel für einen MCP-Einstellungseintrag:

  "mcp-bitpanda": { "transportType": "stdio", "command": "node", "args": [ "/path/to/mcp-bitpanda/build/index.js" ] // Add environment variables, e.g., for the API key "environmentVariables": { "BITPANDA_API_KEY": "YOUR_BITPANDA_API_KEY" // Replace with your actual API key or use a secure method to provide it } // ... other optional settings ... }

Verfügbare Tools

• get_asset_info : Ruft detaillierte Informationen zu einem bestimmten Vermögenswert anhand seines Symbols ab (z. B. BTC, XAU).

  • Parameter: symbol (Zeichenfolge, erforderlich)

  • Hinweis: Für dieses Tool ist kein API-Schlüssel erforderlich.

• get_ohlc : Ruft OHLC-Daten (Open/High/Low/Close) für einen bestimmten Vermögenswert, eine bestimmte Fiat-Währung und einen bestimmten Zeitrahmen ab.

  • Parameter:

    • symbol (Zeichenfolge, erforderlich): Das Handelssymbol.

    • fiatCurrency (Zeichenfolge, erforderlich): Die Fiat-Währung (z. B. USD, EUR).

    • timeframe (Zeichenfolge, erforderlich): Entweder „Tag“ oder „Woche“.

  • Hinweis: Für dieses Tool ist kein API-Schlüssel erforderlich.

• list_trades : Listet alle Trades des Benutzers über die Bitpanda API auf. Die neuesten Trades werden zuerst angezeigt. Die Antwort ist mit Cursor-Paginierung versehen.

  • Parameter:

    • type (Zeichenfolge, optional): Entweder buy oder sell .

    • cursor (Zeichenfolge, optional): ID des letzten bekannten Handels des Kunden. Es werden nur Handelsgeschäfte nach dieser ID zurückgegeben. Ein leerer oder fehlender Cursor-Parameter gibt Handelsgeschäfte vom Anfang an zurück.

    • page_size (Ganzzahl, optional): Größe einer Seite für die paginierte Antwort.

• list_asset_wallets : Listet alle Asset-Wallets des Benutzers gruppiert nach Asset-Typ aus der Bitpanda-API auf.

  • Parameter: Keine.

• list_fiat_wallets : Listet alle Fiat-Wallets des Benutzers aus der Bitpanda-API auf.

  • Parameter: Keine.

• list_fiat_transactions : Listet alle Fiat-Transaktionen des Benutzers über die Bitpanda-API auf. Die neuesten Fiat-Transaktionen werden zuerst angezeigt. Die Antwort ist mit Cursor-Paginierung versehen.

  • Parameter:

    • type (Zeichenfolge, optional): Kaufen, Verkaufen, Einzahlen, Abheben, Überweisen, Rückerstattung.

    • status (Zeichenfolge, optional): ausstehend, in Verarbeitung, abgeschlossen, abgebrochen.

    • cursor (Zeichenfolge, optional): ID der letzten bekannten Fiat-Transaktion des Clients. Es werden nur Fiat-Transaktionen nach dieser ID zurückgegeben. Ein leerer oder fehlender Cursor-Parameter gibt Fiat-Transaktionen vom Anfang an zurück.

    • page_size (Ganzzahl, optional): Größe einer Seite für die paginierte Antwort.

• list_crypto_wallets : Listet alle Krypto-Wallets des Benutzers aus der Bitpanda-API auf.

  • Parameter: Keine.

• list_crypto_transactions : Listet alle Krypto-Transaktionen des Benutzers über die Bitpanda-API auf. Die neuesten Krypto-Transaktionen werden zuerst angezeigt. Die Antwort ist mit Cursor-Paginierung versehen.

  • Parameter:

    • type (Zeichenfolge, optional): Einer von buy , sell , deposit , withdrawal , transfer , refund oder ico .

    • status (Zeichenfolge, optional): Einer der folgenden: pending , processing , unconfirmed_transaction_out , open_invitation , finished oder canceled .

    • cursor (Zeichenfolge, optional): ID der letzten bekannten Kryptotransaktion des Clients. Es werden nur Kryptotransaktionen nach dieser ID zurückgegeben. Ein leerer oder fehlender Cursorparameter gibt Kryptotransaktionen vom Anfang an zurück.

    • page_size (Ganzzahl, optional): Größe einer Seite für die paginierte Antwort.

• list_commodity_transactions : Listet alle Rohstofftransaktionen des Benutzers über die Bitpanda API auf. Die neuesten Rohstofftransaktionen werden zuerst angezeigt. Die Antwort ist mit Cursor-Paginierung versehen.

  • Parameter:

    • cursor (Zeichenfolge, optional): ID der letzten bekannten Rohstofftransaktion des Kunden. Es werden nur Rohstofftransaktionen nach dieser ID zurückgegeben. Ein leerer oder fehlender Cursorparameter gibt Rohstofftransaktionen vom Anfang an zurück.

    • page_size (Ganzzahl, optional): Größe einer Seite für die paginierte Antwort.

Erweitern

Um weitere Bitpanda-API-Endpunkte als Tools hinzuzufügen, implementieren Sie eine neue Tool-Datei in src/tools/ und registrieren Sie sie in src/tools/index.ts .