bnbchain-mcp

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

Мощный набор инструментов для взаимодействия с BNB Chain и другими сетями, совместимыми с EVM, посредством обработки естественного языка и помощи искусственного интеллекта.

Описание

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

Основные модули

Проект состоит из нескольких основных модулей:

Блоки : запросы и управление блоками блокчейна
Контракты : взаимодействие со смарт-контрактами
Сеть : Сетевая информация и управление
NFT : операции NFT (ERC721/ERC1155)
Токены : Операции с токенами (ERC20)
Транзакции : Управление транзакциями
Кошелек : Операции и управление кошельком
Общие : общие утилиты и типы
Greenfield : Поддержка операций по управлению файлами в сети Greenfield, включая загрузку, скачивание и управление файлами и контейнерами.
Скоро появятся дополнительные функции (Greenfield, Swap, Bridge и т. д.)

Интеграция с курсором

Чтобы подключиться к серверу MCP из Курсора:

Откройте Курсор и перейдите в Настройки (значок шестеренки в правом верхнем углу)
Нажмите «MCP» на левой боковой панели.
Нажмите «Добавить новый глобальный сервер MCP».
Введите следующие данные:

Режим по умолчанию

{
  "mcpServers": {
    "bnbchain-mcp": {
      "command": "npx",
      "args": ["-y", "@bnb-chain/mcp@latest"],
      "env": {
        "PRIVATE_KEY": "your_private_key_here. (optional)"
      }
    }
  }
}

режим SSE

{
  "mcpServers": {
    "bnbchain-mcp": {
      "command": "npx",
      "args": ["-y", "@bnb-chain/mcp@latest", "--sse"],
      "env": {
        "PRIVATE_KEY": "your_private_key_here. (optional)"
      }
    }
  }
}

Интеграция с Claude Desktop

Чтобы подключиться к серверу MCP из Claude Desktop:

Откройте Claude Desktop и перейдите в «Настройки».
Нажмите «Разработчик» на левой боковой пане��и.
Нажмите кнопку «Изменить конфигурацию».
Добавьте следующую конфигурацию в файл claude_desktop_config.json :

{
  "mcpServers": {
    "bnbchain-mcp": {
      "command": "npx",
      "args": ["-y", "@bnb-chain/mcp@latest"],
      "env": {
        "PRIVATE_KEY": "your_private_key_here"
      }
    }
  }
}

Сохраните файл и перезапустите Claude Desktop.

После подключения вы можете использовать все подсказки и инструменты MCP непосредственно в разговорах Claude Desktop. Например:

«Проанализируйте этот адрес: 0x123...»
«Объясните концепцию EVM газа»
«Проверьте последний блок на BSC»

Интеграция с другими клиентами

Если вы хотите интегрировать BNBChain MCP в свой собственный клиент, ознакомьтесь с каталогом примеров для получения более подробной информации и справочных реализаций.

Примеры демонстрируют:

Как настроить MCP-клиент
Аутентификация и конфигурация
Выполнение вызовов API для взаимодействия с сетями блокчейнов
Обработка ответов и ошибок
Лучшие практики интеграции

Местное развитие

Предпосылки

бан v1.2.10 или выше
Node.js v17 или выше

Быстрый старт

Клонируйте репозиторий:

git clone https://github.com/bnb-chain/bnbchain-mcp.git
cd bnbchain-mcp

Настройте переменные среды:

cp .env.example .env

Отредактируйте файл .env в соответствии со своей конфигурацией:

PRIVATE_KEY : Ваш закрытый ключ кошелька (требуется для транзакционных операций)
LOG_LEVEL : Установить уровень ведения журнала (DEBUG, INFO, WARN, ERROR)
PORT : Номер порта сервера (по умолчанию: 3001)

Установите зависимости и запустите сервер разработки:

# Install project dependencies
bun install

# Start the development server
bun dev:sse

Тестирование с клиентами MCP

Настройте локальный сервер в ваших клиентах MCP, используя этот шаблон:

{
  "mcpServers": {
    "bnbchain-mcp": {
      "url": "http://localhost:3001/sse",
      "env": {
        "PRIVATE_KEY": "your_private_key_here"
      }
    }
  }
}

Тестирование с помощью веб-интерфейса

Мы используем @modelcontextprotocol/inspector для тестирования. Запускаем тестовый UI:

bun run test

Доступные сценарии

bun dev:sse : Запустить сервер разработки с горячей перезагрузкой
bun build : Построить проект
bun test : запуск тестового набора

Доступные подсказки и инструменты

Подсказки

Имя	Описание
анализировать_блок	Проанализируйте блок и предоставьте подробную информацию о его содержимом
анализировать_транзакцию	Анализ конкретной транзакции
анализировать_адрес	Анализ адреса EVM
взаимодействовать_с_контрактом	Получите руководство по взаимодействию со смарт-контрактом
объясните_концепцию_evm	Получите объяснение концепции EVM
сравнить_сети	Сравните различные сети, совместимые с EVM
анализировать_токен	Анализ токена ERC20 или NFT

Инструменты

Имя	Описание
получить_блок_по_хешу	Получить блок по хешу
получить_блок_по_номеру	Получить блок по номеру
получить_последний_блок	Получить последний блок
получить_транзакцию	Получите подробную информацию о конкретной транзакции по ее хэшу
получить_транзакционный_квитанцию	Получить квитанцию о транзакции по ее хэшу
оценка_газа	Оцените стоимость газа для транзакции
transfer_native_token	Перевод собственных токенов (BNB, ETH, MATIC и т. д.) на адрес
одобрить_расход_токена	Одобрите другой адрес для траты ваших токенов ERC20
трансфер_нфт	Передача NFT (токена ERC721) с одного адреса на другой
передача_erc1155	Перевести токены ERC1155 на другой адрес
передача_erc20	Перевод токенов ERC20 на адрес
получить_адрес_из_частного_ключа	Получить адрес EVM, полученный из закрытого ключа
получить_цепочку_информацию	Получить информацию о цепочке для определенной сети
получить_поддерживаемые_сети	Получить список поддерживаемых сетей
resolve_ens	Преобразовать имя ENS в адрес EVM
is_contract	Проверьте, является ли адрес смарт-контрактом или внешней учетной записью (EOA)
читать_контракт	Считывание данных из смарт-контракта путем вызова функции view/pure
написать_контракт	Запись данных в смарт-контракт путем вызова функции изменения состояния
получить_erc20_token_info	Получить информацию о токене ERC20
получить_родной_баланс	Получить баланс собственного токена для адреса
получить_erc20_баланс	Получить баланс токена ERC20 для адреса
получить_nft_информацию	Получите подробную информацию о конкретном NFT
проверка_nft_владения	Проверьте, принадлежит ли адрес определенному NFT
get_erc1155_token_uri	Получите URI метаданных для токена ERC1155
получить_nft_баланс	Получить общее количество NFT, принадлежащих адресу из определенной коллекции
получить_erc1155_баланс	Получить баланс определенного идентификатора токена ERC1155, принадлежащего адресу
gnfd_get_bucket_info	Получите подробную информацию о конкретном сегменте
gnfd_list_buckets	Список всех контейнеров, принадлежащих адресу
gnfd_create_bucket	Создать новый контейнер
gnfd_delete_bucket	Удалить ведро
gnfd_get_object_info	Получить подробную информацию о конкретном объекте
gnfd_list_objects	Перечислить все объекты в корзине
gnfd_upload_object	Загрузить объект в корзину
gnfd_download_object	Загрузить объект из корзины
gnfd_delete_object	Удалить объект из корзины
gnfd_create_folder	Создать папку в корзине

Поддерживаемые сети

Поддерживает BSC, opBNB, Greenfield, Ethereum и другие основные сети, совместимые с EVM. Для получения более подробной информации см. src/evm/chains.ts .

Внося вклад

Мы приветствуем пожертвования в BNBChain MCP! Вот как вы можете помочь:

Форк репозитория
Создать ветку функций
Примите ваши изменения
Нажмите на свою ветку
Создать запрос на извлечение

Убедитесь, что ваш код соответствует нашим стандартам кодирования и включает соответствующие тесты.

Лицензия

Данный проект лицензирован по лицензии MIT — подробности см. в файле LICENSE .

Ссылки и благодарности

Этот проект создан на основе и вдохновлен следующими проектами с открытым исходным кодом:

TermiX-official/bsc-mcp — Оригинальная реализация BSC MCP
mcpdotdirect/evm-mcp-server — реализация сервера MCP, совместимая с EVM

Мы выражаем благодарность авторам оригинала за их вклад в экосистему блокчейна.

You must be authenticated.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Tools

View all tools

bnbchain-mcp

Related Resources

Reddit Discussion about this server

Related MCP Servers

ygocdb-mcp
lieyanqzu
A
security
A
license
A
quality
ygocdb-mcp
Last updated -
3
JavaScript
MIT License
dbt-mcpofficial
dbt-labs
A
security
A
license
A
quality
dbt-mcp
Last updated -
16
203
Python
Apache 2.0
akshare-one-mcp
zwldarren
A
security
A
license
A
quality
akshare-one-mcp
Last updated -
7
9
Python
MIT License
modbus-mcp
kukapay
-
security
A
license
-
quality
modbus-mcp
Last updated -
2
Python
MIT License

View all related MCP servers

bnbchain-mcp

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

Описание

Основные модули

Интеграция с курсором

Интеграция с Claude Desktop

Интеграция с другими клиентами

Местное развитие

Предпосылки

Быстрый старт

Тестирование с клиентами MCP

Тестирование с помощью веб-интерфейса

Доступные сценарии

Доступные подсказки и инструменты

Подсказки

Инструменты

Поддерживаемые сети

Внося вклад

Лицензия

Ссылки и благодарности

Tools

Related Resources

Related MCP Servers

ygocdb-mcp

dbt-mcpofficial

akshare-one-mcp

modbus-mcp

New MCP Servers

MCP directory API