关键词

EVM区块链智能合约交互加密钱包操作NFT管理链上数据查询

使用说明

项目简介

BNBChain MCP 是一个实现了 Model Context Protocol (MCP) 的后端服务器。它专门用于通过AI或自然语言界面（如支持MCP的LLM客户端）与BNB Chain及其他EVM兼容的区块链网络进行交互。它将复杂的区块链操作和数据查询封装成标准化的工具和可引导的Prompt，使开发者和用户能以更直观的方式访问链上信息和执行操作。

主要功能点

该服务器提供以下核心功能：

  • 区块链数据查询： 获取最新的区块信息、根据哈希或高度查询特定区块。
  • 交易管理： 查询交易详情、交易回执，估算交易所需的Gas费用。
  • 智能合约交互： 检查地址是否为合约、调用智能合约的只读（view/pure）函数读取数据，或调用可写（state-changing）函数发送交易（需提供私钥）。
  • 数字资产管理： 查询地址的原生代币（如BNB、ETH）、ERC20代币、ERC721 (NFT) 和 ERC1155 代币余额。
  • 代币/NFT转账： 发送原生代币、ERC20代币、ERC721 (NFT) 和 ERC1155 代币（需提供发送账户的私钥）。
  • ERC20代币授权： 授权其他地址（如DeFi协议）代表您花费特定数量的ERC20代币（需提供授权账户的私钥）。
  • 钱包地址功能： 从私钥派生出对应的链上地址。
  • 网络信息查询： 获取当前链的ID、最新区块号、RPC地址，或获取服务器支持的网络列表。
  • ENS域名解析： 将ENS域名解析为对应的EVM地址（注意：ENS主要在以太坊网络上使用）。
  • AI辅助： 提供用于解释EVM概念、比较不同网络的Prompt模板，引导AI进行相关主题的讨论。

安装步骤

BNBChain MCP 通常由支持MCP协议的客户端（如Cursor、Claude Desktop等）自动下载和运行，您无需手动克隆仓库或编译代码。

  1. 安装 Node.js 或 Bun: 确保您的计算机已安装 Node.js (v16 或更高版本) 或 Bun (1.2.10 或更高版本)。这些是运行服务器所需的JavaScript运行时环境。您可以从官方网站下载安装包。
  2. 通过客户端配置: 在您的MCP客户端软件中，按照其文档指引添加新的MCP服务器。通常需要提供服务器的启动命令。

服务器配置

MCP客户端通过配置来启动并连接服务器。BNBChain MCP 服务器的启动命令通常是通过 'npx' 来执行最新版本。以下是配置所需的关键信息（具体配置界面请参考您的MCP客户端）：

  • 服务器名称 (Server Name): 例如 'bnbchain-mcp' (用于客户端识别)
  • 命令 (Command): 'npx'
  • 参数 (Args):
    • 对于默认的 Stdio 模式：'["-y", "@bnb-chain/mcp@latest"]'
    • 对于 SSE 模式：'["-y", "@bnb-chain/mcp@latest", "--sse"]' (如果您需要通过HTTP/SSE连接，例如用于Web应用，尽管LLM客户端常用Stdio)
  • 环境变量 (Environment): 可选，用于配置敏感信息，例如：
    • 'PRIVATE_KEY': 您的以太坊账户私钥 (用于进行代币转移、合约写入等需要签名交易的操作)。请务必注意私钥安全，仅在信任的环境下配置，并理解其风险。 (格式通常是'"PRIVATE_KEY": "your_private_key_here"')

例如，在支持MCP的客户端配置中，您可能需要添加类似如下结构的配置项（具体字段名和格式请参考客户端文档）：

{
  "mcpServers": {
    "bnbchain-mcp": {
      "command": "npx",
      "args": ["-y", "@bnb-chain/mcp@latest"],
      // 如果需要进行代币转移、合约写入等操作，需要配置私钥
      // "env": {
      //   "PRIVATE_KEY": "您的私钥（注意安全风险！）"
      // }
    }
  }
}

基本使用方法

配置完成后，启动您的MCP客户端。客户端会自动启动 BNBChain MCP 服务器。

  1. 选择服务器: 在客户端界面中选择您刚刚配置并启动的 'bnbchain-mcp' 服务器。
  2. 自然语言交互: 直接在聊天或命令界面使用自然语言向AI提问或发出指令，服务器会根据您的问题调用相应的工具或Prompt模板。
    • 例如：
      • "Check the latest block on BSC" (检查BSC上的最新区块)
      • "Analyze address 0x123... on Ethereum" (分析以太坊网络上的地址 0x123...)
      • "Explain the EVM concept of gas" (解释EVM中gas的概念)
      • "Transfer 0.1 BNB to 0xabc... on BSC" (向BSC上的地址 0xabc... 发送 0.1 BNB) - 注意：执行此操作前请确保已在配置中安全地提供了 'PRIVATE_KEY' 并理解风险。
  3. 工具调用: 有些客户端可能允许直接调用工具。您可以根据服务器提供的工具列表（如上文和仓库README中列出的）进行调用。

请查阅您的MCP客户端文档，以获取更详细的服务器连接和交互指南。

信息

分类

开发者工具

访问项目