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

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

Deploy Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

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

dbt-mcpofficial
dbt-labs
A
security
A
license
A
quality
dbt-mcp
Last updated -
16
378
Apache 2.0
linkedmcp
buddhdev-harsh
-
security
A
license
-
quality
linkedmcp
Last updated -
MIT License
blocknative-mcp
kukapay
A
security
A
license
A
quality
blocknative-mcp
Last updated -
3
3
MIT License
mcp-chain-of-thought
liorfranko
A
security
A
license
A
quality
mcp-chain-of-thought
Last updated -
15
23
19
MIT License

View all related MCP servers