关键词

区块链Web3CoinbaseBase Sepolia智能合约

使用说明

项目简介

Base MCP Server 是一个基于 Model Context Protocol (MCP) 构建的应用后端，旨在扩展 Claude 等 LLM 客户端的能力，使其能够安全、便捷地与 Base 区块链和 Coinbase 服务进行交互。该服务器通过提供一系列预定义的 工具 (Tools)，允许 Claude 执行链上操作，例如查询钱包地址、获取测试网 ETH、列出账户余额、转移资金以及部署智能合约。

主要功能点

  • 钱包地址查询: 获取与服务器配置的钱包关联的区块链地址。
  • 测试网 ETH 获取: 在 Base Sepolia 测试网络上为钱包申请免费的测试 ETH。
  • 账户余额查询: 列出钱包中各种加密货币的余额信息。
  • 资金转移: 将钱包中的资金转移到指定的区块链地址。
  • 智能合约部署: 在区块链上部署用户提供的智能合约代码。

安装步骤

本MCP服务器可以通过 npm 或从源代码安装。

方法一：通过 npm 安装 (推荐)

  1. 打开终端，运行以下命令全局安装 'base-mcp'： 
    npm install -g base-mcp
    或者，您也可以在您的项目目录下本地安装： 
    npm install base-mcp

方法二：从源代码安装

  1. 克隆 GitHub 仓库到本地： 
    git clone https://github.com/dschlabach/base-mcp-alpha.git
cd base-mcp-alpha
  2. 安装项目依赖： 
    npm install
  3. 构建项目： 
    npm run build
  4. （可选）全局链接，方便在任何地方运行： 
    npm link

服务器配置

为了让 Claude Desktop 等 MCP 客户端能够连接并使用 Base MCP Server，您需要配置客户端的 MCP 服务器设置。以下是 Claude Desktop 的配置示例，您需要将其添加到 Claude Desktop 的配置文件 'claude_desktop_config.json' 中。

Claude Desktop 配置文件路径：

  • macOS: '~/Library/Application Support/Claude/claude_desktop_config.json'
  • Windows: '%APPDATA%\Claude\claude_desktop_config.json'
  • Linux: '~/.config/Claude/claude_desktop_config.json'

配置信息 (JSON 格式):

{
  "mcpServers": {
    "base-mcp": {
      "command": "node",
      "args": ["/path/to/base-mcp/build/index.js"],
      "env": {
        "COINBASE_API_KEY_NAME": "your_api_key_name",
        "COINBASE_API_PRIVATE_KEY": "your_private_key",
        "SEED_PHRASE": "your seed phrase here"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

参数说明:

  • '"base-mcp"': 服务器名称，可以自定义。
  • '"command": "node"': 运行服务器的命令，这里使用 Node.js。
  • '"args": ["/path/to/base-mcp/build/index.js"]': 启动服务器的参数，指向 'base-mcp' 构建后的入口文件 'index.js' 的绝对路径。请将 '/path/to/base-mcp' 替换为您实际的 'base-mcp' 项目路径。 如果您是全局安装的，并且 'base-mcp' 命令在您的 PATH 环境变量中，您可以尝试简化 'args'，具体取决于全局安装的结构。
  • '"env"': 环境变量配置，包含连接 Coinbase API 和钱包所需的密钥和助记词。
    • '"COINBASE_API_KEY_NAME": "your_api_key_name"': 您的 Coinbase API 密钥名称，请替换为您的实际 API 密钥名称。
    • '"COINBASE_API_PRIVATE_KEY": "your_private_key"': 您的 Coinbase API 私钥，请替换为您的实际 API 私钥。
    • '"SEED_PHRASE": "your seed phrase here"': 您的钱包助记词，用于访问和管理您的区块链钱包，请务必妥善保管，不要泄露。
  • '"disabled": false': 设置为 'false' 表示启用该 MCP 服务器。
  • '"autoApprove": []': 自动批准的工具列表，默认为空，表示所有工具都需要用户手动批准才能执行。

重要安全提示: 配置文件中包含敏感信息（API 密钥和助记词），请务必妥善保管配置文件，避免泄露。建议使用环境变量或更安全的凭 credential manager 管理敏感信息。

基本使用方法

配置完成后，重启 Claude Desktop。您可以通过自然语言指令指示 Claude 使用 Base MCP Server 提供的工具。

例如：

  • 查询钱包地址: 在 Claude 中输入 'What's my wallet address?'
  • 获取测试网 ETH: 在 Claude 中输入 'Can you get me some testnet ETH for my wallet?'
  • 查询账户余额: 在 Claude 中输入 'Show me my wallet balances.'
  • 转移资金: 在 Claude 中输入 'Transfer 0.01 ETH to 0x1234567890abcdef1234567890abcdef12345678.' (请替换为实际的目标地址和金额)
  • 部署智能合约: 在 Claude 中输入 'Deploy a simple ERC20 token contract for me.' (部署智能合约需要提供更详细的合约代码和参数，请参考仓库中的 'examples.md' 文件)

Claude 会识别这些指令并调用 Base MCP Server 提供的相应工具来执行链上操作，并将结果返回给您。

信息

分类

开发者工具

访问项目