Сервер Binance MCP

Обзор

Binance MCP Server — это бэкэнд-сервис, разработанный для взаимодействия с API Binance. Он обеспечивает бесперебойное взаимодействие с биржей Binance, позволяя пользователям просматривать свой портфель, конвертировать токены и совершать сделки с минимальным влиянием на рынок. Сервер использует фреймворк Model Context Protocol (MCP) для обеспечения безопасных, структурированных и эффективных транзакций.

Основные функции:

• Взаимодействовать с API биржи Binance для получения информации об аккаунте и торговли

• Отображение состава и оценки портфеля

• Выполняйте интеллектуальные преобразования токенов с минимизацией влияния на рынок

• Обработка рыночных ордеров и алгоритмических торговых стратегий

• Получайте торговые данные и информацию о счетах в режиме реального времени

• Реализуйте структурированные транзакции с использованием фреймворка Model Context Protocol

• Обеспечьте безопасную аутентификацию и управление ключами API для интеграции Binance

Функции

• [x] Интеграция API Binance : подключение к бирже Binance для получения информации об аккаунте и торговых операций

• [x] Управление портфелем : просмотр подробного состава портфеля, рыночной стоимости и процентного распределения

• [x] Аналитика портфеля : дополнительное отслеживание исторических значений для мониторинга производительности с течением времени

• [x] Интеллектуальная конвертация токенов : конвертация токенов с помощью интеллектуальных стратегий исполнения заказов

• [x] Смягчение влияния на рынок : автоматическое использование алгоритмической торговли для крупных заказов с целью предотвращения проскальзывания цен.

• [x] Управление счетом : получение подробной информации о счете, балансе и истории торговли.

• [x] Доступ к рыночным данным : доступ к книгам заказов и рыночным данным в режиме реального времени для принятия обоснованных торговых решений.

• [x] Исполнение ордеров : размещайте ордера на спотовом рынке с гибкими спецификациями количества

• [ ] Поддержка алгоритмической торговли : реализация ордеров на основе средневзвешенной по времени цены (TWAP) для минимизации влияния на рынок

• [ ] Автоматизированная торговля : выполнение сделок программным путем на основе предопределенных стратегий

• [ ] Безопасная аутентификация : управление ключами API и безопасные подключения к сервисам Binance

• [ ] Комплексная обработка ошибок : подробные отчеты об ошибках при сбоях транзакций и проблемах API

Требования

Перед настройкой сервера Binance MCP убедитесь, что у вас установлено следующее:

• Node.js (v16 или более поздняя версия)

• нпм или пряжа

• Ключ и секрет API Binance (для интеграции с биржей Binance)

• Действительный закрытый ключ кошелька Binance Smart Chain (BSC) (для транзакций в блокчейне)

Установка

Клонируйте репозиторий и установите зависимости:

Конфигурация

Для настройки сервера создайте файл .env в корневом каталоге и укажите следующие переменные:

Создание ключа API Binance

Перед использованием интеграции API Binance вам необходимо создать ключ API. Это позволит вам подключаться к серверам Binance с помощью нескольких языков программирования, извлекать данные из Binance и взаимодействовать с внешними приложениями. Вы можете просматривать данные своего кошелька и транзакций, совершать сделки, а также вносить и выводить средства в сторонних программах.

Предварительные условия:

• Вам необходимо внести депозит на любую сумму на ваш Spot Wallet, чтобы активировать ваш аккаунт.

• Полная проверка личности

• Включите двухфакторную аутентификацию (2FA) в своей учетной записи

Шаги по созданию ключа API Binance:

1. Войдите в свою учетную запись Binance и нажмите на значок профиля, затем [Учетная запись].

2. Перейдите в [Управление API], затем нажмите [Создать API].

3. Выберите предпочитаемый тип ключа API:

   • Сгенерированные системой ключи API (симметричное шифрование HMAC) — вы получите ключ API и секретный ключ.

   • Самостоятельно сгенерированные ключи API (асимметричное шифрование Ed25519 или RSA) — вы получите ключ API, но вам придется создать собственную пару открытого и закрытого ключей.

4. Введите метку/имя для вашего ключа API.

5. Выполните верификацию с помощью устройств 2FA и паролей.

6. Ваш ключ API создан.

Более подробную информацию о Binance API можно найти в документации Binance API .

Интеграция с Claude Desktop (для нескольких серверов MCP)

Перед интеграцией любого сервера MCP с Claude Desktop убедитесь, что у вас установлено следующее:

• Клод Десктоп

Используйте следующую команду из корня монорепозитория для сборки всех серверов MCP.

Настроить рабочий стол Клода

Каждый сервер MCP имеет свою собственную конфигурацию. Для интеграции отдельного сервера MCP:

1. Перейдите в папку сервера MCP (например, packages/binance-spot-mcp ).

2. Откройте файл config.example.json .

3. Используйте содержимое этого файла для создания записи в конфигурации Claude Desktop:

Расположение файла конфигурации рабочего стола Claude

Пример записи конфигурации

Вот как может выглядеть один сервер MCP ( binance-spot-mcp ):

Примечание: обязательно замените путь args на фактическое расположение вашего build/index.js и скопируйте значения env из config.example.json этого сервера.

Перезапустите Claude Desktop, чтобы новая конфигурация вступила в силу.

Использование (для подключения хостов MCP, отличных от Claude)

У вас есть три варианта запуска серверов MCP в зависимости от ваших потребностей:

Вариант 1: сборка и запуск всех серверов MCP

Вариант 2: сборка и запуск всех серверов MCP за один шаг

Вариант 3: запуск определенного сервера MCP

Для запуска отдельного сервера используйте следующую команду:

🔸 Пример:

Функции

Функции API Binance

1. Получить информацию об учетной записи Binance -

   Получает полную информацию о вашем аккаунте Binance, включая балансы, торговые разрешения и статус аккаунта.

2. Получить снимок учетной записи Binance -

   Получает снимок состояния вашего счета Binance, включая текущую информацию о цене BTC. Включает историю за последние 30 дней.

3. Проверить книгу заказов Binance -

   { "symbol": "BTCUSDT" }

   Извлекает текущую книгу ордеров для указанной торговой пары, отображая доступные ордера на покупку и продажу глубиной до 50 уровней.

4. Разместить заказ на спотовом рынке -

   { "symbol": "BTCUSDT", "side": "BUY", "quantity": 0.001, // OR "quoteOrderQty": 100 }

   Размещает рыночный ордер для немедленного исполнения по лучшей доступной цене. Используйте quantity для указания суммы базового актива или quoteOrderQty для указания суммы в валюте котировки. Подходит для небольших ордеров.

5. Разместить заказ TWAP -

   { "symbol": "BTCUSDT", "side": "BUY", "quantity": 1.0, "duration": 3600 }

   Размещает ордер Time-Weighted Average Price (TWAP), который выполняется постепенно в течение указанного периода времени, чтобы минимизировать влияние рынка. Подходит для крупных ордеров, которые в противном случае могли бы вызвать значительные движения цен.

Модель контекстного протокола (MCP)

Model Context Protocol (MCP) — это открытый стандарт, разработанный для улучшения взаимодействия приложений с моделями ИИ и вычислительными системами на основе блокчейна. MCP устанавливает структурированный контекст, который повышает эффективность автоматизированных транзакций и децентрализованных приложений.

Преимущества МКП:

• Стандартизация : определяет единый подход к взаимодействию приложений.

• Эффективность : снижает вычислительные затраты и повышает скорость транзакций.

• Взаимодействие : поддерживает интеграцию между различными платформами и блокчейн-экосистемами.

Обработка ошибок

При сбое транзакции сервер возвращает сообщение об ошибке с подробностями. Проверьте журналы консоли для получения дополнительной отладочной информации. Распространенные сценарии ошибок включают:

• Недостаточно средств в кошельке

• Неверный адрес получателя

• Перегрузка сети или проблемы RPC

• Ошибки аутентификации API Binance

• Ограничения по торговым лимитам

Лицензия

Этот проект имеет открытый исходный код по лицензии MIT.

Для внесения вклада, сообщения об ошибках или запроса функций отправьте запрос на GitHub .