关键词

Base NetworkCoinbase APIon-chain toolsWeb3链上工具

使用说明

项目简介

Base MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器实现，旨在为 AI 应用程序（如 Claude Desktop 和 Cursor）提供与 Base 区块链网络和 Coinbase API 交互的能力。它通过提供一系列预定义的工具，使得 AI 应用能够安全、便捷地访问和操作区块链上的资源，例如获取钱包地址、查询余额、转移资金、部署智能合约、进行链上借贷、购买OpenRouter积分等。

主要功能点

  • 链上操作工具: 提供丰富的工具集，涵盖钱包管理、资产查询、交易执行、智能合约交互等，使 AI 应用具备强大的链上操作能力。
  • Base 网络集成: 深度集成 Base 区块链网络，支持与 Base 网络上的智能合约和去中心化应用进行交互。
  • Coinbase API 支持: 利用 Coinbase API，实现链上资产的便捷管理，并支持通过 Coinbase Onramp 功能进行法币入金。
  • OpenRouter 积分购买: 集成 OpenRouter API，允许用户使用 USDC 购买 OpenRouter 平台的 AI 服务积分。
  • 易于集成: 提供详细的 Claude Desktop 集成指南，方便用户快速将该 MCP 服务器接入到 Claude 等 AI 应用中。

安装步骤

  1. 安装 Node.js: 确保已安装 Node.js (v16 或更高版本) 和 npm 或 yarn 包管理器。
  2. 选择安装方式:
    • 方式一：从 npm 安装 (推荐) 
      npm install -g base-mcp
    • 方式二：从源码安装 
      git clone https://github.com/base/base-mcp.git
cd base-mcp
npm install
npm run build
npm link # 可选，全局链接
  3. 配置环境变量:
    • 在项目根目录下创建 '.env' 文件，并根据 'README.md' 中的 "Configuration" 部分，填入你的 Coinbase API 凭据、钱包助记词、Coinbase Project ID (用于 onramp 功能) 和 OpenRouter API Key (可选，用于购买 OpenRouter 积分)。
    • 环境变量配置示例如下： 
      COINBASE_API_KEY_NAME=your_api_key_name
COINBASE_API_PRIVATE_KEY=your_private_key
SEED_PHRASE=your seed phrase here
COINBASE_PROJECT_ID=your_project_id
OPENROUTER_API_KEY=your_openrouter_api_key

服务器配置

要将 Base MCP Server 集成到 MCP 客户端（例如 Claude Desktop），你需要配置客户端以连接到该服务器。以下是针对 Claude Desktop 的配置示例，你需要将以下 JSON 配置添加到 Claude Desktop 的配置文件 'claude_desktop_config.json' 中。

{
  "mcpServers": {
    "base-mcp": {  // 服务器名称，可以自定义
      "command": "node",  // 启动服务器的命令，这里使用 node
      "args": ["/path/to/base-mcp/build/index.js"], // 服务器启动参数，指向编译后的 index.js 文件路径，需要替换为实际路径
      "env": {  // 环境变量配置，与 .env 文件中的配置相同，但可以直接嵌入到 JSON 中
        "COINBASE_API_KEY_NAME": "your_api_key_name",  // 你的 Coinbase API Key Name
        "COINBASE_API_PRIVATE_KEY": "your_private_key", // 你的 Coinbase API Private Key
        "SEED_PHRASE": "your seed phrase here", // 你的钱包助记词
        "COINBASE_PROJECT_ID": "your_project_id", // 你的 Coinbase Project ID
        "OPENROUTER_API_KEY": "your_openrouter_api_key" // 你的 OpenRouter API Key (可选)
      },
      "disabled": false,  // 设置为 false 启用该服务器
      "autoApprove": []   // 自动批准的工具列表，默认为空
    }
  }
}

注意:

  • 请将 '"args"' 中的 '/path/to/base-mcp/build/index.js' 替换为你实际 'base-mcp' 项目的编译后 'index.js' 文件的绝对路径。如果你是全局安装的 'base-mcp'，则需要找到全局安装的路径并指向 'index.js' 文件。更推荐的方式是从源码安装，并根据实际情况填写路径。
  • '"env"' 部分的环境变量配置与 '.env' 文件作用相同，但直接嵌入到 JSON 配置中，方便 Claude Desktop 读取。请根据你的实际凭据替换示例值。
  • 配置完成后，重启 Claude Desktop 使配置生效。

基本使用方法

  1. 启动 MCP 客户端: 启动配置了 Base MCP Server 的 MCP 客户端，例如 Claude Desktop。
  2. 与 AI 应用交互: 通过自然语言与 AI 应用进行交互，例如在 Claude 中提问 "What's my wallet address?" 或 "Transfer 0.01 ETH to 0x1234567890abcdef1234567890abcdef12345678."。
  3. 体验链上工具: AI 应用会根据你的指令，调用 Base MCP Server 提供的工具，完成相应的链上操作，并将结果返回给你。

更多示例: 请参考仓库中的 'examples.md' 文件，了解如何通过 Claude 与 Base MCP Server 提供的工具进行更详细的交互。

信息

分类

网页与API

访问项目