MCP Bitpanda Server

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 .