bnbchain-mcp

BNB Chain MCP スキル

BNB Chain MCP サーバーへの接続方法と、ブロック、トランザクション、コントラクト、トークン、NFT、ウォレット、ERC-8004 エージェント、Greenfield のツールの使用方法です。MCP 経由で BNB Chain／opBNB／EVM または Greenfield を操作する場合に、このスキルを使用してください。

---

接続と認証情報

• サーバーの実行： npx @bnb-chain/mcp@latest（実行時に npm から取得します）。ソース：github.com/bnb-chain/bnbchain-mcp。
• RPC： デフォルトのチェーンでは組み込み RPC を使用します。セルフホストする場合やカスタム RPC を使用する場合を除き、設定は不要です。
• PRIVATE_KEY： 読み取り専用（ブロック、残高、コントラクトの読み取り）の場合は省略するか、空のままにします。状態を変更するツール（送金、write_contract、approve_token_spending、ERC-8004 の登録／set_uri、Greenfield への書き込み）には、MCP サーバーの env に設定します。秘密鍵をログに記録したり、公開したりしないでください。
• 読み取り専用と状態変更： ブロック／残高／コントラクト読み取りツールはキーなしで動作します。送金と書き込みには、サーバー環境で PRIVATE_KEY が必要です。

---

1. MCP サーバーの設定

MCP クライアントの設定（例：Cursor MCP の設定、Claude Desktop の claude_desktop_config.json）に bnbchain-mcp サーバーを追加します。

デフォルト（stdio）：

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

SSE モード： "args": ["-y", "@bnb-chain/mcp@latest", "--sse"]（必要に応じてクライアントの SSE URL も設定します）。ローカル開発サーバー（例：bnbchain-mcp で bun dev:sse を実行する場合）：同じ env を使って "url": "http://localhost:3001/sse" を設定します。

設定を変更した後は、MCP クライアントを再起動または再読み込みして、サーバーを起動してください。

---

2. 認証情報と環境

• RPC： デフォルトのチェーンでは組み込み RPC を使用します。
• PRIVATE_KEY： 状態変更ツールが必要な場合はサーバーの env に設定し、読み取り専用の場合は空のままにします。キーをコミットしたり、出力したりしないでください。

---

3. エージェントの登録（ERC-8004）

1. MCP ツール register_erc8004_agent を使って、オンチェーンでエージェントを登録します（references/erc8004-tools-reference.md を参照）。
2. 登録後、所有者は 8004scan（メインネット）または 8004scan（テストネット）で登録を確認できます。

---

4. クイックリファレンス — ツールとプロンプト

ネットワークパラメーター

• 読み取り専用ツール（ブロック、残高、コントラクトの読み取り、get_chain_info など）：network は省略可能です。デフォルトは bsc です。選択肢の一覧には get_supported_networks を使用してください。
• 書き込み操作（transfer_native_token、transfer_erc20、transfer_nft、transfer_erc1155、approve_token_spending、write_contract、register_erc8004_agent、set_erc8004_agent_uri、Greenfield への書き込み）：network は必須です。 書き込み操作にはデフォルト値がありません。ユーザーがネットワークを指定していない場合は、ツールを呼び出す前に必ず確認してください。メインネット（bsc）だと仮定したり、デフォルトで選択したりしないでください。誤ってメインネットで実行すると、取り消せない金銭的損失が発生します。

ツールのカテゴリ

カテゴリ	例	PRIVATE_KEY が必要？
ブロック	get_latest_block、get_block_by_number、get_block_by_hash	いいえ
トランザクション	get_transaction、get_transaction_receipt、estimate_gas	いいえ（見積もりのみ）
ネットワーク	get_chain_info、get_supported_networks	いいえ
ウォレット／残高	get_native_balance、get_erc20_balance、get_address_from_private_key	残高：アドレスまたは privateKey は省略可能
送金／書き込み	transfer_native_token、transfer_erc20、transfer_nft、transfer_erc1155、approve_token_spending、write_contract	はい
コントラクト	read_contract、is_contract	読み取りには不要
トークン／NFT	get_erc20_token_info、get_nft_info、get_erc1155_token_metadata、check_nft_ownership、get_nft_balance、get_erc1155_balance	読み取りには不要
ERC-8004	register_erc8004_agent、set_erc8004_agent_uri、get_erc8004_agent、get_erc8004_agent_wallet	register／set_uri：はい
Greenfield	gnfd_* バケット／オブジェクト／支払いツール	書き込み：はい

プロンプト（MCP プロンプト）

ユーザーが分析やガイダンスを求めている場合は、MCP プロンプト名を使用します。

• analyze_block — ブロックとその内容を分析する
• analyze_transaction — 特定のトランザクションを分析する
• analyze_address — EVM アドレスを分析する
• interact_with_contract — スマートコントラクトとのやり取りに関するガイダンス
• explain_evm_concept — EVM の概念を説明する
• compare_networks — EVM 互換ネットワークを比較する
• analyze_token — ERC20 または NFT トークンを分析する
• how_to_register_mcp_as_erc8004_agent — MCP を ERC-8004 エージェントとして登録する方法に関するガイダンス

---

5. リファレンスファイル（ツールごとの使用方法）

各ツールのパラメーター名、例、詳細な使用方法については、以下を参照してください。

リファレンス	内容
references/evm-tools-reference.md	ブロック、トランザクション、ネットワーク、ウォレット、コントラクト、トークン、NFT — すべての EVM ツール
references/erc8004-tools-reference.md	register_erc8004_agent、set_erc8004_agent_uri、get_erc8004_agent、get_erc8004_agent_wallet
references/greenfield-tools-reference.md	バケット、オブジェクト、フォルダー、支払いアカウント — すべての Greenfield ツール
references/prompts-reference.md	すべての MCP プロンプトと使用するタイミング

---

6. 安全性とベストプラクティス

1. トランザクションの送信前に確認する： transfer_*、write_contract、または approve_token_spending を使用する前に、受取人、金額、ネットワークを確認してください。
2. 書き込みにはネットワークの指定が必要： 書き込み（送金、write_contract、approve_token_spending、ERC-8004 の register/set_uri）を行う場合、ユーザーが明示したネットワークを必ず確認してください。指定がない場合は、ユーザーに確認を求めてください。デフォルトでメインネットを使用してはいけません。「テストネットを推奨します」のような助言で代用してはいけません。制約は、ネットワークの指定がない場合、ユーザーが確認するまで書き込みツールを呼び出さないことです。
3. 秘密鍵： MCP サーバーの env にのみ設定してください。チャットやログには決して記録しないでください。
4. ERC-8004 の agentURI： Agent Metadata Profile に準拠した JSON メタデータ（name、description、image、MCP エンドポイントなどの services）。

---

ドキュメントへのリンク

• BNB Chain MCP リポジトリ： https://github.com/bnb-chain/bnbchain-mcp
• npm： npx @bnb-chain/mcp@latest
• ERC-8004（Identity Registry）；agentURI の形式については Agent Metadata Profile を参照。