MCP Bitpanda Server

Servidor Bitpanda MCP

Un servidor de Protocolo de Contexto de Modelo (MCP) que expone herramientas para interactuar con la API de Bitpanda. Este servidor permite el acceso programático a funciones de Bitpanda, como operaciones, monederos y transacciones, mediante el protocolo MCP.

Prerrequisitos

• Node.js (se recomienda v18 o posterior)
• npm (viene con Node.js)
• Una clave API de Bitpanda (establecida como variable de entorno BITPANDA_API_KEY )
• (Opcional) Cliente o ejecutor compatible con MCP (por ejemplo, extensión VSCode, CLI)

Configuración

1. Clone el repositorio o asegúrese de estar en el directorio del proyecto.
2. Instalar dependencias:
   npm install
3. Construir el servidor:
   npm run build
   Esto creará un directorio build con el código JavaScript compilado.

Ejecución del servidor

• Directamente:
  node build/index.js
  o, si tienes un script de inicio:
  npm run start
• Mediante el ejecutor MCP: Configure su cliente MCP para ejecutar el servidor mediante el transporte stdio. Ejemplo de entrada de configuración de MCP:
  "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 ... }

Herramientas disponibles

• get_asset_info : recupera información detallada de un activo específico por su símbolo (por ejemplo, BTC, XAU).
  • Parámetros: symbol (cadena, obligatorio)
  • Nota: Esta herramienta no requiere una clave API.
• get_ohlc : recupera datos OHLC (Apertura/Máximo/Mínimo/Cierre) para un activo específico, una moneda fiduciaria y un período de tiempo.
  • Parámetros:
    • symbol (cadena, obligatorio): El símbolo comercial.
    • fiatCurrency (cadena, obligatoria): la moneda fiduciaria (por ejemplo, USD, EUR).
    • timeframe (cadena, obligatorio): "día" o "semana".
  • Nota: Esta herramienta no requiere una clave API.
• list_trades : Lista todas las operaciones del usuario desde la API de Bitpanda. Las más recientes aparecen primero. La respuesta se pagina con el cursor.
  • Parámetros:
    • type (cadena, opcional): Uno de buy o sell .
    • cursor (cadena, opcional): ID de la última operación conocida por el cliente. Solo se devuelven las operaciones posteriores a este ID. Si el parámetro cursor está vacío o falta, se devolverán las operaciones desde el principio.
    • page_size (entero, opcional): tamaño de una página para la respuesta paginada.
• list_asset_wallets : enumera todas las billeteras de activos del usuario agrupadas por tipo de activo desde la API de Bitpanda.
  • Parámetros: Ninguno.
• list_fiat_wallets : enumera todas las billeteras fiduciarias del usuario desde la API de Bitpanda.
  • Parámetros: Ninguno.
• list_fiat_transactions : Lista todas las transacciones fiat del usuario desde la API de Bitpanda. Las transacciones fiat más recientes aparecen primero. La respuesta se pagina con el cursor.
  • Parámetros:
    • type (cadena, opcional): comprar, vender, depositar, retirar, transferir, reembolso.
    • status (cadena, opcional): pendiente, procesando, terminado, cancelado.
    • cursor (cadena, opcional): ID de la última transacción fiat conocida por el cliente. Solo se devuelven las transacciones fiat posteriores a este ID. Si el parámetro cursor está vacío o falta, se devolverán las transacciones fiat desde el principio.
    • page_size (entero, opcional): tamaño de una página para la respuesta paginada.
• list_crypto_wallets : enumera todas las billeteras de criptomonedas del usuario desde la API de Bitpanda.
  • Parámetros: Ninguno.
• list_crypto_transactions : Lista todas las transacciones de criptomonedas del usuario desde la API de Bitpanda. Las transacciones más recientes aparecen primero. La respuesta se pagina con el cursor.
  • Parámetros:
    • type (cadena, opcional): uno de buy , sell , deposit , withdrawal , transfer , refund o ico .
    • status (cadena, opcional): Uno de los siguientes: pending , processing , unconfirmed_transaction_out , open_invitation , finished o canceled .
    • cursor (cadena, opcional): ID de la última transacción de criptomonedas conocida por el cliente. Solo se devuelven las transacciones de criptomonedas posteriores a este ID. Si el parámetro cursor está vacío o falta, se devolverán las transacciones de criptomonedas desde el principio.
    • page_size (entero, opcional): tamaño de una página para la respuesta paginada.
• list_commodity_transactions : Lista todas las transacciones de materias primas del usuario desde la API de Bitpanda. Las transacciones más recientes aparecen primero. La respuesta se pagina con el cursor.
  • Parámetros:
    • cursor (cadena, opcional): ID de la última transacción de producto conocida por el cliente. Solo se devuelven las transacciones de producto posteriores a este ID. Si el parámetro cursor está vacío o falta, se devolverán las transacciones de producto desde el principio.
    • page_size (entero, opcional): tamaño de una página para la respuesta paginada.

Extensión

Para agregar más puntos finales de API de Bitpanda como herramientas, implemente un nuevo archivo de herramientas en src/tools/ y regístrelo en src/tools/index.ts .