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 .