BNBChain MCP（モデルコンテキストプロトコル）

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

説明

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

コアモジュール

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

ブロック:ブロックチェーンブロックのクエリと管理
契約: スマートコントラクトと対話する
ネットワーク: ネットワーク情報と管理
NFT : NFT (ERC721/ERC1155) 運用
トークン：トークン（ERC20）の運用
トランザクション: トランザクション管理
ウォレット：ウォレットの操作と管理
共通: 共有ユーティリティとタイプ
グリーンフィールド: ファイルとバケットのアップロード、ダウンロード、管理など、グリーンフィールドネットワーク上のファイル管理操作をサポートします。
追加機能は近日中に公開予定です (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との統合

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

Claudeデスクトップを開き、設定に移動します
左側のサイドバーの「開発者」をクリックします
「設定を編集」ボタンをクリックします
claude_desktop_config.jsonファイルに次の構成を追加します。

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

ファイルを保存し、Claude Desktopを再起動します。

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

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

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

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

例は以下を示します。

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

地域開発

前提条件

bun 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"
      }
    }
  }
}

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トークンを使用するための別のアドレスを承認する
転送_nft	NFT（ERC721トークン）をあるアドレスから別のアドレスに転送する
転送_erc1155	ERC1155トークンを別のアドレスに転送する
転送_erc20	ERC20トークンをアドレスに転送する
秘密鍵からアドレスを取得する	秘密鍵から導出されたEVMアドレスを取得する
get_chain_info	特定のネットワークのチェーン情報を取得する
get_supported_networks	サポートされているネットワークのリストを取得する
解決_ens	ENS名をEVMアドレスに解決する
契約である	アドレスがスマートコントラクトか外部所有アカウント (EOA) かを確認する
契約書を読む	ビュー/純粋関数を呼び出してスマートコントラクトからデータを読み取る
契約書を書く	状態変更関数を呼び出してスマートコントラクトにデータを書き込む
get_erc20_token_info	ERC20トークン情報を取得する
ネイティブバランスを取得する	アドレスのネイティブトークン残高を取得する
erc20残高を取得する	アドレスのERC20トークン残高を取得する
get_nft_info	特定のNFTに関する詳細情報を取得する
NFTの所有権の確認	アドレスが特定のNFTを所有しているかどうかを確認する
get_erc1155_token_uri	ERC1155トークンのメタデータURIを取得する
NFT残高を取得する	特定のコレクションからアドレスが所有するNFTの総数を取得する
get_erc1155_balance	アドレスが所有する特定のERC1155トークンIDの残高を取得する
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 - EVM互換のMCPサーバー実装

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

bnbchain-mcp

BNBChain MCP（モデルコンテキストプロトコル）

説明

コアモジュール

カーソルとの統合

Claude Desktopとの統合

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

地域開発

前提条件

クイックスタート

MCPクライアントによるテスト

Web UI によるテスト

利用可能なスクリプト

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

プロンプト

ツール

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

貢献

ライセンス

参考文献と謝辞

Tools

Related Resources

Related MCP Servers

dbt-mcpofficial

linkedmcp

blocknative-mcp

mcp-chain-of-thought

New MCP Servers

MCP directory API