MCP Bitpanda Server

MCP Bitpanda Сервер

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

Предпосылки

• Node.js (рекомендуется версия 18 или более поздняя)
• npm (входит в состав Node.js)
• Ключ API Bitpanda (задается как переменная среды BITPANDA_API_KEY )
• (Необязательно) MCP-совместимый клиент или средство запуска (например, расширение VSCode, CLI)

Настраивать

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 .