MCP Bitpanda Сервер

Сервер Model Context Protocol (MCP), который предоставляет инструменты для взаимодействия с API Bitpanda. Этот сервер обеспечивает программный доступ к функциям Bitpanda, таким как сделки, кошельки и транзакции через протокол MCP.

Предпосылки

• Node.js (рекомендуется версия 18 или более поздняя)

• npm (входит в состав Node.js)

• Ключ API Bitpanda (задается как переменная среды BITPANDA_API_KEY )

• (Необязательно) MCP-совместимый клиент или средство запуска (например, расширение VSCode, CLI)

Related MCP server: MCP YNAB Server

Настраивать

1. Клонируйте репозиторий или убедитесь, что вы находитесь в каталоге проекта.

2. Установить зависимости:

   npm install

3. Сборка сервера:

   npm run build

   Это создаст каталог build со скомпилированным кодом JavaScript.

Запуск сервера

• Напрямую:

  node build/index.js

  или, если у вас есть стартовый скрипт:

  npm run start

• Через MCP runner: Настройте клиент MCP для запуска сервера с использованием stdio transport. Пример записи настроек 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 ...
  }

Доступные инструменты

• get_asset_info : получает подробную информацию о конкретном активе по его символу (например, BTC, XAU).

  • Параметры: symbol (строка, обязательно)

  • Примечание: для этого инструмента не требуется ключ API.

• get_ohlc : извлекает данные OHLC (открытие/максимум/минимум/закрытие) для определенного актива, фиатной валюты и таймфрейма.

  • Параметры:

    • symbol (строка, обязательно): торговый символ.

    • fiatCurrency (строка, обязательно): фиатная валюта (например, USD, EUR).

    • timeframe (строка, обязательно): «день» или «неделя».

  • Примечание: для этого инструмента не требуется ключ API.

• list_trades : Список всех сделок пользователя из API Bitpanda. Самые новые сделки идут первыми. Ответ разбивается на страницы курсором.

  • Параметры:

    • type (строка, необязательно): одно из двух: buy или sell .

    • cursor (строка, необязательно): идентификатор последней известной сделки клиента. Возвращаются только сделки после этого идентификатора. Пустой или отсутствующий параметр курсора вернет сделки с самого начала.

    • page_size (целое число, необязательно): Размер страницы для постраничного ответа.

• list_asset_wallets : выводит список всех кошельков активов пользователя, сгруппированных по типу активов из API Bitpanda.

  • Параметры: Нет.

• list_fiat_wallets : Выводит список всех фиатных кошельков пользователя из API Bitpanda.

  • Параметры: Нет.

• list_fiat_transactions : Список всех фиатных транзакций пользователя из API Bitpanda. Самые новые фиатные транзакции идут первыми. Ответ разбивается на страницы с помощью курсора.

  • Параметры:

    • type (строка, необязательно): покупка, продажа, депозит, снятие, перевод, возврат.

    • status (строка, необязательно): ожидание, обработка, завершено, отменено.

    • cursor (строка, необязательно): идентификатор последней известной фиатной транзакции клиента. Возвращаются только фиатные транзакции после этого идентификатора. Пустой или отсутствующий параметр курсора вернет фиатные транзакции с самого начала.

    • page_size (целое число, необязательно): Размер страницы для постраничного ответа.

• list_crypto_wallets : список всех криптокошельков пользователя из API Bitpanda.

  • Параметры: Нет.

• list_crypto_transactions : Список всех криптотранзакций пользователя из API Bitpanda. Самые новые криптотранзакции идут первыми. Ответ разбивается на страницы курсором.

  • Параметры:

    • type (строка, необязательно): один из вариантов buy , sell , deposit , withdrawal , transfer , refund или ico .

    • status (строка, необязательно): один из следующих: pending , processing , unconfirmed_transaction_out , open_invitation , finished или canceled .

    • cursor (строка, необязательно): Идентификатор последней известной криптотранзакции клиентом. Возвращаются только криптотранзакции после этого идентификатора. Пустой или отсутствующий параметр курсора вернет криптотранзакции с самого начала.

    • page_size (целое число, необязательно): Размер страницы для постраничного ответа.

• list_commodity_transactions : Перечисляет все товарные транзакции пользователя из API Bitpanda. Самые новые товарные транзакции идут первыми. Ответ разбивается на страницы с помощью курсора.

  • Параметры:

    • cursor (строка, необязательно): идентификатор последней известной клиенту товарной транзакции. Возвращаются только товарные транзакции после этого идентификатора. Пустой или отсутствующий параметр курсора вернет товарные транзакции с самого начала.

    • page_size (целое число, необязательно): Размер страницы для постраничного ответа.

Расширение

Чтобы добавить больше конечных точек API Bitpanda в качестве инструментов, реализуйте новый файл инструмента в src/tools/ и зарегистрируйте его в src/tools/index.ts .