bnbchain-mcp

BNB Chain MCP 技能

了解如何连接 BNB Chain MCP 服务并使用其工具：区块、交易、合约、代币、NFT、钱包、ERC-8004 Agent 和 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 注册/设置 URI、Greenfield 写入），请在 MCP 服务的 env 中设置。切勿记录或泄露私钥。
• 只读与更改状态的操作： 区块/余额/合约读取工具无需密钥即可使用；转账和写入操作需要在服务环境中设置 PRIVATE_KEY。

---

1. 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 客户端，以便启动服务。

---

2. 凭据与环境

• RPC： 默认链已内置。
• PRIVATE_KEY： 需要使用会更改状态的工具时，请在服务的 env 中设置；只读操作则留空。不要提交或回显密钥。

---

3. Agent 注册（ERC-8004）

1. 使用 MCP 工具 register_erc8004_agent 在链上注册 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	注册/设置 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 Agent

---

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 注册/设置 URI），必须有用户明确指定的网络。如果未指定，请询问——不要默认使用主网。不要用“建议优先使用测试网”等建议性措辞替代；约束是：未指定网络 → 在用户确认前不得调用写入工具。
3. 私钥： 仅保存在 MCP 服务的 env 中；不得出现在聊天或日志中。
4. ERC-8004 agentURI： 符合 Agent Metadata Profile 的 JSON 元数据（名称、描述、图片、服务，例如 MCP 端点）。

---

文档链接

• BNB Chain MCP 仓库： https://github.com/bnb-chain/bnbchain-mcp
• npm： npx @bnb-chain/mcp@latest
• ERC-8004（身份注册表）；用于 agentURI 格式的 Agent Metadata Profile。