Сервер 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) (для транзакций в блокчейне)

Установка

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

git clone https://github.com/your-repo/binance-mcp-server.git
cd binance-mcp-server
yarn install  # or npm install

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

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

# Binance API Configuration
BINANCE_API_KEY=your_binance_api_key_here
BINANCE_API_SECRET=your_binance_api_secret_here

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

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

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

Вам необходимо внести депозит на любую сумму на ваш Spot Wallet, чтобы активировать ваш аккаунт.
Полная проверка личности
Включите двухфакторную аутентификацию (2FA) в своей учетной записи

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

Войдите в свою учетную запись Binance и нажмите на значок профиля, затем [Учетная запись].
Перейдите в [Управление API], затем нажмите [Создать API].
Выберите предпочитаемый тип ключа API:
- Сгенерированные системой ключи API (симметричное шифрование HMAC) — вы получите ключ API и секретный ключ.
- Самостоятельно сгенерированные ключи API (асимметричное шифрование Ed25519 или RSA) — вы получите ключ API, но вам придется создать собственную пару открытого и закрытого ключей.
Введите метку/имя для вашего ключа API.
Выполните верификацию с помощью устройств 2FA и паролей.
Ваш ключ API создан.

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

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

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

Клод Десктоп

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

yarn build

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

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

Перейдите в папку сервера MCP (например, packages/binance-spot-mcp ).
Откройте файл config.example.json .
Используйте содержимое этого файла для создания записи в конфигурации Claude Desktop:

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

Платформа	Путь
macOS	`~/Library/Application Support/Claude/claude_desktop_config.json`
Окна	`%APPDATA%\Claude\claude_desktop_config.json`
линукс	`~/.config/Claude/claude_desktop_config.json`

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

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

{
    "mcpServers": {
        "binance-spot-mcp": {
            "command": "node",
            "args": ["/Users/Username/Desktop/binance-mpc/packages/packages/binance-spot-mcp/build/index.js"],
            "env": {
                "BINANCE_API_KEY": "BINANCE_API_KEY",
                "BINANCE_API_SECRET": "BINANCE_API_SECRET"
            },
            "disabled": false,
            "autoApprove": []
        }
    }
}

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

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

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

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

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

yarn build     # Step 1: Build all packages
yarn start     # Step 2: Start all MCP servers concurrently

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

yarn server    # This builds and runs all MCP servers in one go

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

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

yarn server:<mcp-server-name>

🔸 Пример:

yarn server:binance-spot-mcp

Функции

Функции API Binance

Получить информацию об учетной записи Binance - binanceAccountInfoПолучает полную информацию о вашем аккаунте Binance, включая балансы, торговые разрешения и статус аккаунта.
Получить снимок учетной записи Binance - binanceAccountSnapshotПолучает снимок состояния вашего счета Binance, включая текущую информацию о цене BTC. Включает историю за последние 30 дней.
Проверить книгу заказов Binance - binanceOrderBook
{ "symbol": "BTCUSDT" }
Извлекает текущую книгу ордеров для указанной торговой пары, отображая доступные ордера на покупку и продажу глубиной до 50 уровней.
Разместить заказ на спотовом рынке - binanceSpotPlaceOrder
{ "symbol": "BTCUSDT", "side": "BUY", "quantity": 0.001, // OR "quoteOrderQty": 100 }
Размещает рыночный ордер для немедленного исполнения по лучшей доступной цене. Используйте quantity для указания суммы базового актива или quoteOrderQty для указания суммы в валюте котировки. Подходит для небольших ордеров.
Разместить заказ TWAP - binanceTimeWeightedAveragePriceFutureAlgo
{ "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 .

Binance MCP Server

Integrations