bnbchain-mcp

Official
by bnb-chain
MIT License
353
2

Integrations

  • Provides tools for interacting with BNB Chain through natural language, including blockchain queries, smart contract interaction, wallet management, token operations, and NFT management.

  • Supports local development with Bun, providing setup instructions and development scripts for running and testing the MCP server.

  • Supports interaction with Ethereum and other EVM-compatible networks, enabling blockchain development, smart contract interaction, and network management through AI-powered interfaces.

BNBChain MCP(モデルコンテキストプロトコル)

自然言語処理と AI アシスタンスを通じて BNB チェーンやその他の EVM 互換ネットワークと対話するための強力なツールキット。

説明

BNBChain MCPは、AIを活用したインターフェースを通じてブロックチェーンネットワークとのシームレスな連携を可能にするモデルコンテキストプロトコル(CMP)実装です。ブロックチェーン開発、スマートコントラクト連携、ネットワーク管理のための包括的なツールとリソースを提供します。

コアモジュール

このプロジェクトは、いくつかのコアモジュールで構成されています。

  • ブロック:ブロックチェーンブロックのクエリと管理
  • 契約: スマートコントラクトと対話する
  • ネットワーク: ネットワーク情報と管理
  • NFT : NFT (ERC721/ERC1155) 運用
  • トークン:トークン(ERC20)の運用
  • トランザクション: トランザクション管理
  • ウォレット:ウォレットの操作と管理
  • 共通: 共有ユーティリティとタイプ
  • 追加機能は近日中に公開予定です (Greenfield、Swap、Bridge など)

カーソルとの統合

カーソルから MCP サーバーに接続するには:

  1. カーソルを開いて設定(右上の歯車アイコン)に移動します
  2. 左サイドバーの「MCP」をクリックします
  3. 「新しいグローバルMCPサーバーを追加」をクリックします
  4. 次の詳細を入力してください。

デフォルトモード

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

SSEモード

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

Claude Desktopとの統合

Claude Desktop から MCP サーバーに接続するには:

  1. Claudeデスクトップを開き、設定に移動します
  2. 左側のサイドバーの「開発者」をクリックします
  3. 「設定を編集」ボタンをクリックします
  4. claude_desktop_config.jsonファイルに次の構成を追加します。
{ "mcpServers": { "bnbchain-mcp": { "command": "npx", "args": ["-y", "@bnb-chain/mcp@latest"], "env": { "PRIVATE_KEY": "your_private_key_here" } } } }
  1. ファイルを保存し、Claude Desktopを再起動します。

接続すると、Claude Desktop の会話で MCP のすべてのプロンプトとツールを直接使用できるようになります。例:

  • 「このアドレスを分析します: 0x123...」
  • 「ガスのEVM概念を説明する」
  • 「BSCで最新のブロックを確認してください」

他のクライアントとの統合

BNBChain MCP を独自のクライアントに統合する場合は、より詳細な情報とリファレンス実装については、例のディレクトリを参照してください。

例は以下を示します。

  • MCPクライアントの設定方法
  • 認証と構成
  • ブロックチェーンネットワークとやりとりするためのAPI呼び出し
  • 応答とエラーの処理
  • 統合のベストプラクティス

地域開発

前提条件

クイックスタート

  1. リポジトリをクローンします。
git clone https://github.com/bnb-chain/bnbchain-mcp.git cd bnbchain-mcp
  1. 環境変数を設定します。
cp .env.example .env

設定に合わせて.envファイルを編集します。

  • PRIVATE_KEY : ウォレットの秘密鍵(トランザクション操作に必要)
  • LOG_LEVEL : ログレベルを設定する (DEBUG、INFO、WARN、ERROR)
  • PORT : サーバーのポート番号(デフォルト: 3001)
  1. 依存関係をインストールし、開発サーバーを起動します。
# 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" } } } }
Web UI によるテスト

テストには@modelcontextprotocol/inspectorを使用します。テストUIを起動します。

bun run test
利用可能なスクリプト
  • bun dev:sse : ホットリロードで開発サーバーを起動する
  • bun build : プロジェクトをビルドする
  • bun test : テストスイートを実行する

利用可能なプロンプトとツール

プロンプト

名前説明
分析ブロックブロックを分析し、その内容に関する詳細な情報を提供する
トランザクション分析特定の取引を分析する
分析アドレスEVMアドレスを分析する
契約とのやり取りスマートコントラクトとのやり取りに関するガイダンスを入手する
EVMの概念を説明するEVMの概念の説明を受ける
比較ネットワークさまざまなEVM互換ネットワークを比較する
トークン分析ERC20またはNFTトークンを分析する

ツール

名前説明
get_block_by_hashハッシュでブロックを取得する
番号でブロックを取得番号でブロックを取得する
最新ブロックを取得する最新のブロックを取得する
get_transactionハッシュによって特定のトランザクションの詳細情報を取得する
トランザクションレシートの取得ハッシュでトランザクションレシートを取得する
推定ガス取引にかかるガスコストを見積もる
ネイティブトークンの転送ネイティブトークン(BNB、ETH、MATICなど)をアドレスに転送する
トークン支出の承認ERC20トークンを使用するための別のアドレスを承認する
転送_nftNFT(ERC721トークン)をあるアドレスから別のアドレスに転送する
転送_erc1155ERC1155トークンを別のアドレスに転送する
転送_erc20ERC20トークンをアドレスに転送する
秘密鍵からアドレスを取得する秘密鍵から導出されたEVMアドレスを取得する
get_chain_info特定のネットワークのチェーン情報を取得する
get_supported_networksサポートされているネットワークのリストを取得する
解決_ensENS名をEVMアドレスに解決する
契約であるアドレスがスマート コントラクトか外部所有アカウント (EOA) かを確認する
契約書を読むビュー/純粋関数を呼び出してスマートコントラクトからデータを読み取る
契約書を書く状態変更関数を呼び出してスマートコントラクトにデータを書き込む
get_erc20_token_infoERC20トークン情報を取得する
ネイティブバランスを取得するアドレスのネイティブトークン残高を取得する
erc20残高を取得するアドレスのERC20トークン残高を取得する
get_nft_info特定のNFTに関する詳細情報を取得する
NFTの所有権の確認アドレスが特定のNFTを所有しているかどうかを確認する
get_erc1155_token_uriERC1155トークンのメタデータURIを取得する
NFT残高を取得する特定のコレクションからアドレスが所有するNFTの総数を取得する
get_erc1155_balanceアドレスが所有する特定のERC1155トークンIDの残高を取得する

サポートされているネットワーク

BSC、opBNB、Ethereum、その他主要なEVM互換ネットワークをサポートしています。詳細については、 src/evm/chains.tsを参照してください。

貢献

BNBChain MCPへの貢献を歓迎します!ご協力いただける方法は以下の通りです。

  1. リポジトリをフォークする
  2. 機能ブランチを作成する
  3. 変更をコミットする
  4. ブランチにプッシュする
  5. プルリクエストを作成する

コードが当社のコーディング標準に準拠し、適切なテストが含まれていることを確認してください。

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。

参考文献と謝辞

このプロジェクトは、次のオープンソース プロジェクトに基づいて構築され、インスピレーションを受けています。

ブロックチェーン エコシステムへの貢献に対して、元の著者の方々に感謝の意を表します。

Related MCP Servers

View all related MCP servers

ID: t6zbvd82tr