JinDaGe - base-mcp-server MCP Details

article

README

🚀 基础网络 - MCP服务器

这是一款专为Base网络设计的MCP服务器，它能让大语言模型（LLM）通过自然语言命令，在Base网络上轻松执行各类区块链操作，如钱包管理、余额查询和交易执行等，大大提升了操作的便捷性。该服务器同时支持Base主网和Base Sepolia测试网。

🚀 快速开始

工具介绍

以下工具可助力你在Base网络上开展操作：

process_command：处理Base网络操作的自然语言命令。它接受一个参数command，即自然语言命令（例如，“将0.5 ETH发送到0x1234...”），并返回结构化的响应，包含操作结果，如发送操作的交易详情、余额检查信息以及钱包创建细节。
create_wallet：在Base网络上创建新钱包。可传入一个可选参数name，即钱包的名称，返回一个对象，包含钱包地址、名称和其他详细信息。
check_balance：检查钱包的余额。可传入一个可选参数wallet，即要查询余额的钱包名称或地址（默认为默认钱包），返回ETH余额。
list_wallets：列出所有可用钱包，返回一个数组，其中包含每个钱包对象，每个对象包含钱包地址、名称和其他详细信息。

使用方法

与Claude Desktop一起使用

Claude Desktop是一款流行的LLM客户端，支持模型上下文协议。你可以将Base MCP服务器连接到Claude Desktop，通过自然语言命令执行区块链操作。要将你的Base MCP服务器添加到Claude Desktop，请在以下配置文件中添加相应的配置：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json 要在Claude Desktop中添加你的Base MCP服务器，请将以下配置添加到mcpServers对象中：

{
  "mcpServers": {
    "base": {
      "command": "npx",
      "args": [
        "-y",
        "base-network-mcp-server"
      ],
      "env": {
        "BASE_PROVIDER_URL": "https://api.developer.coinbase.com/rpc/v1/base/YOUR_API_KEY",
        "WALLET_PRIVATE_KEY": "your_private_key_here"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

配置说明

BASE_PROVIDER_URL: Base主网或测试网的RPC端点
WALLET_PRIVATE_KEY: 用于钱包签名交易的私钥

📦 安装指南

使用以下命令安装Base网络MCP服务器：

npm install base-network-mcp-server
# 或者
yarn add base-network-mcp-server
# 或者
pnpm add base-network-mcp-server

💻 使用示例

基础用法

以下是如何使用此库的示例代码：

import { createMcpServer } from 'base-network-mcp-server';

async function main() {
  const server = await createMcpServer({
    providerUrl: 'https://api.developer.coinbase.com/rpc/v1/base/YOUR_API_KEY',
    privateKey: 'your_private_key_here'
  });

  // 发送交易
  const transaction = await server.processCommand('将0.5 ETH发送到0x1234567890123456789012345678901234567890');

  // 查询余额
  const balance = await server.checkBalance();

  // 创建钱包
  const wallet = await server.createWallet('我的新钱包');

  // 列出所有钱包
  const wallets = await server.listWallets();
}

main().catch(console.error);

⚠️ 安全注意事项

由于此实现与实际区块链网络交互并处理私钥，因此请务必注意以下几点：

私钥安全：确保私钥的安全性，绝不在版本控制中提交。
先使用测试网：在切换到主网之前，先在Sepolia测试网上进行操作。
交易验证：总是验证交易参数。
错误处理：实现强大的错误处理机制以应对网络问题。
速率限制：注意API调用的速率限制。

base-mcp-server