BNB Chain MCP 技能用于连接 BNB Chain MCP 服务器并使用其提供的工具，适用于通过 MCP 操作 BNB Chain、opBNB、EVM 兼容链或 Greenfield 的场景。
用途 该技能覆盖区块、交易、合约、代币、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 服务器环境中设置。切勿记录或暴露私钥。 只读与状态变更：区块/余额/合约读取工具无需密钥；转账和写入需要在服务器环境中提供 PRIVATE_KEY。
MCP 服务器配置 将 bnbchain-mcp 服务器添加到 MCP 客户端配置（如 Cursor MCP 设置、Claude Desktop 的 claude_desktop_config.json）。 默认（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）："url": "http://localhost:3001/sse"，使用相同 env。 修改配置后需重启或重新加载 MCP 客户端，使服务器启动。
凭据与环境 RPC：默认链使用内置 RPC。 PRIVATE_KEY：需要状态变更工具时在服务器 env 中设置；只读时留空。不要提交或回显密钥。
智能体注册（ERC-8004） 使用 MCP 工具 register_erc8004_agent 在链上注册智能体（参见 references/erc8004-tools-reference.md）。所有者随后可在 8004scan（主网）或 8004scan（测试网）查看注册情况。
工具与提示快速参考 网络参数： 只读工具（区块、余额、合约读取、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）；误在主网执行会造成不可逆的财务损失。
工具分类： 区块：get_latest_block、get_block_by_number、get_block_by_hash，无需 PRIVATE_KEY。 交易：get_transaction、get_transaction_receipt、estimate_gas，无需 PRIVATE_KEY（仅估算）。 网络：get_chain_info、get_supported_networks，无需 PRIVATE_KEY。 钱包/余额：get_native_balance、get_erc20_balance、get_address_from_private_key；余额查询可选 address 或 privateKey。 转账/写入：transfer_native_token、transfer_erc20、transfer_nft、transfer_erc1155、approve_token_spending、write_contract，需要 PRIVATE_KEY。 合约：read_contract、is_contract，读取无需 PRIVATE_KEY。 代币/NFT：get_erc20_token_info、get_nft_info、get_erc1155_token_metadata、check_nft_ownership、get_nft_balance、get_erc1155_balance，读取无需 PRIVATE_KEY。 ERC-8004：register_erc8004_agent、set_erc8004_agent_uri、get_erc8004_agent、get_erc8004_agent_wallet；注册/set_uri 需要 PRIVATE_KEY。 Greenfield：gnfd_* 存储桶/对象/支付工具；写入需要 PRIVATE_KEY。
提示（MCP prompts）： 当用户需要分析或指导时，使用以下 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 智能体的指导
参考文件（各工具用法）： 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 提示及其使用时机。
安全与最佳实践 发送交易前确认：对于 transfer_*、write_contract 或 approve_token_spending，调用工具前确认接收方、金额和网络。 写操作必须指定网络：任何写入（转账、write_contract、approve_token_spending、ERC-8004 注册/set_uri）都必须有用户明确指定的网络。若未指定，应询问——不要默认主网。不要用“建议测试网”之类的建议性语言替代该约束；约束是：未指定网络 → 在用户确认前不要调用写入工具。 私钥：仅放在 MCP 服务器 env 中；绝不出现在聊天或日志中。 ERC-8004 agentURI：按 Agent Metadata Profile 提供 JSON 元数据（name、description、image、services，例如 MCP 端点）。
文档链接 BNB Chain MCP 仓库：https://github.com/bnb-chain/bnbchain-mcp npm：npx @bnb-chain/mcp@latest ERC-8004（Identity Registry）；agentURI 格式参见 Agent Metadata Profile。