使用说明

项目简介

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

主要功能点

钱包地址查询: 获取与服务器配置钱包关联的地址。
测试网 ETH 获取: 在 Base Sepolia 测试网络上为钱包请求测试 ETH。
余额查询: 列出钱包中所有资产的余额。
资金转移: 将资金从配置的钱包转移到指定地址。
智能合约部署: 部署智能合约到区块链网络。

安装步骤

安装 Node.js 和 npm: 确保你的系统中已安装 Node.js (v16 或更高版本) 和 npm。

安装 base-mcp: 你可以选择全局安装或本地安装。

全局安装 (推荐):

npm install -g base-mcp

本地安装:

npm install base-mcp

配置环境变量: 创建一个 '.env' 文件，并填入你的 Coinbase API 凭据和钱包助记词：

COINBASE_API_KEY_NAME=你的_API_密钥名称
COINBASE_API_PRIVATE_KEY=你的_API_私钥
SEED_PHRASE=你的_钱包助记词

请从 Coinbase 开发者平台获取 API 密钥，并妥善保管钱包助记词。

服务器配置

要将 Base MCP Server 集成到 MCP 客户端（例如 Claude Desktop），你需要提供以下配置信息。以下是 Claude Desktop 的配置示例，其他 MCP 客户端的配置方式可能类似。

在 Claude Desktop 配置文件 ('claude_desktop_config.json') 的 'mcpServers' 字段中添加以下配置：

{
  "mcpServers": {
    "base-mcp": {
      "command": "node",
      "args": ["/path/to/base-mcp/build/index.js"],
      "env": {
        "COINBASE_API_KEY_NAME": "你的_API_密钥名称",
        "COINBASE_API_PRIVATE_KEY": "你的_API_私钥",
        "SEED_PHRASE": "你的_钱包助记词"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

配置参数说明:

'"base-mcp"': 服务器名称，可以自定义。
'"command": "node"': 启动服务器的命令，这里使用 Node.js 解释器。
'"args": ["/path/to/base-mcp/build/index.js"]': 启动命令的参数，指向 'base-mcp' 服务器构建后的入口文件路径。你需要将 '/path/to/base-mcp' 替换为你实际的 'base-mcp' 项目路径。 如果你是全局安装，则需要找到全局安装的 'base-mcp' 目录下的 'build/index.js' 文件路径。
'"env"': 环境变量配置，用于传递 Coinbase API 凭据和钱包助记词。
- '"COINBASE_API_KEY_NAME"': Coinbase API 密钥名称，从 '.env' 文件或环境变量中读取。
- '"COINBASE_API_PRIVATE_KEY"': Coinbase API 私钥，从 '.env' 文件或环境变量中读取。
- '"SEED_PHRASE"': 钱包助记词，从 '.env' 文件或环境变量中读取。
'"disabled": false': 设置为 'false' 表示启用该 MCP 服务器。
'"autoApprove": []': 自动批准的工具列表，默认为空，表示所有工具都需要手动批准。

请注意: 你需要根据你的实际安装路径和 API 密钥信息，正确配置 'args' 和 'env' 字段。

基本使用方法

配置完成后，在 MCP 客户端 (例如 Claude Desktop) 中，你可以通过自然语言指令调用 Base MCP Server 提供的工具。例如：

询问钱包地址: "What's my wallet address?"
获取测试网 ETH: "Can you get me some testnet ETH for my wallet?"
查询余额: "Show me my wallet balances."
转移资金: "Transfer 0.01 ETH to 0x1234567890abcdef1234567890abcdef12345678."
部署智能合约: "Deploy a simple ERC20 token contract for me." (具体合约参数需要参考 'deploy-contract' 工具的参数说明)

具体工具的使用方法和参数，请参考仓库 README.md 文件中 "Available Tools" 章节的详细描述。

关键词