Сервер 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.
Настроить рабочий стол Клода
Каждый сервер 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Извлекает текущую книгу ордеров для указанной торговой пары, отображая доступные ордера на покупку и продажу глубиной до 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
}
Модель контекстного протокола (MCP)
Model Context Protocol (MCP) — это открытый стандарт, разработанный для улучшения взаимодействия приложений с моделями ИИ и вычислительными системами на основе блокчейна. MCP устанавливает структурированный контекст, который повышает эффективность автоматизированных транзакций и децентрализованных приложений.
Преимущества МКП:
- Стандартизация : определяет единый подход к взаимодействию приложений.
- Эффективность : снижает вычислительные затраты и повышает скорость транзакций.
- Взаимодействие : поддерживает интеграцию между различными платформами и блокчейн-экосистемами.
Обработка ошибок
При сбое транзакции сервер возвращает сообщение об ошибке с подробностями. Проверьте журналы консоли для получения дополнительной отладочной информации. Распространенные сценарии ошибок включают:
- Недостаточно средств в кошельке
- Неверный адрес получателя
- Перегрузка сети или проблемы RPC
- Ошибки аутентификации API Binance
- Ограничения по торговым лимитам
Лицензия
Этот проект имеет открытый исходный код по лицензии MIT.
Для внесения вклада, сообщения об ошибках или запроса функций отправьте запрос на GitHub .