MCP 服务器

Base Network MCP Server

一个 MCP 服务器，它使 LLM 能够通过自然语言命令在 Base 网络上执行区块链操作，包括钱包管理、余额查询和交易执行。

Tools

process_command

Process a natural language command for Base network operations

create_wallet

Create a new wallet

check_balance

Check wallet balance

list_wallets

List all available wallets

README

base-network-mcp-server

这是一个用于 Base 网络的 MCP 服务器。它允许 LLM 通过自然语言命令在 Base 网络上执行区块链操作，包括钱包管理、余额查询和交易执行。

此服务器可与 Base 主网和 Base Sepolia 测试网配合使用。

工具

以下工具可用：

process_command

处理 Base 网络操作的自然语言命令。它接受以下参数：

command: 要处理的自然语言命令（例如，“发送 0.5 ETH 到 0x1234...”）

它返回一个包含操作结果的结构化响应，包括发送操作的交易详情、余额检查的余额信息以及钱包创建的钱包详情。

create_wallet

在 Base 网络上创建一个新钱包。它接受以下参数：

name: (可选) 钱包的名称

它返回一个包含钱包地址、名称和其他详细信息的对象。

check_balance

检查 Base 网络上钱包的余额。它接受以下参数：

wallet: (可选) 要检查的钱包名称或地址（默认为主钱包）

它以 ETH 为单位返回钱包余额。

list_wallets

列出所有可用的钱包。

它返回一个钱包对象数组，每个对象包含钱包地址、名称和其他详细信息。

用法

使用 Claude Desktop

Claude Desktop 是一款流行的 LLM 客户端，支持模型上下文协议。您可以将您的 Base MCP 服务器连接到 Claude Desktop，以通过自然语言命令执行区块链操作。

您可以通过其配置文件将 MCP 服务器添加到 Claude Desktop，配置文件位于：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

要将您的 Base MCP 服务器添加到 Claude Desktop，请将以下配置添加到配置文件中的 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 网络提供商的 URL（主网或 Sepolia）
WALLET_PRIVATE_KEY: 您的钱包私钥，用于身份验证和交易签名
DEFAULT_GAS_PRICE: (可选) 默认 Gas 价格，单位为 Gwei

以编程方式 (自定义 MCP 客户端)

如果您正在构建自己的 MCP 客户端，您可以使用您喜欢的传输方式以编程方式连接到 Base MCP 服务器。 MCP SDK 提供内置的 stdio 和 SSE 传输。

安装

npm i base-network-mcp-server
# or
yarn add base-network-mcp-server
# or
pnpm add base-network-mcp-server

示例

以下示例使用 StreamTransport 在 MCP 客户端和服务器之间直接连接：

import { Client } from '@modelcontextprotocol/sdk/client/index.js';
import { StreamTransport } from '@modelcontextprotocol/sdk/client/stream.js';
import { BaseMcpServer } from 'base-network-mcp-server';

// Create a stream transport for both client and server
const clientTransport = new StreamTransport();
const serverTransport = new StreamTransport();

// Connect the streams together
clientTransport.readable.pipeTo(serverTransport.writable);
serverTransport.readable.pipeTo(clientTransport.writable);

const client = new Client(
  {
    name: 'MyClient',
    version: '0.1.0',
  },
  {
    capabilities: {},
  }
);

// Create and configure the Base MCP server
const server = new BaseMcpServer({
  providerUrl: 'https://api.developer.coinbase.com/rpc/v1/base/YOUR_API_KEY',
  privateKey: 'your_private_key_here',
});

// Connect the client and server to their respective transports
await server.connect(serverTransport);
await client.connect(clientTransport);

// Call tools
const output = await client.callTool({
  name: 'process_command',
  arguments: {
    command: 'Check my wallet balance',
  },
});

console.log(output);
// Example output:
// {
//   "success": true,
//   "message": "Balance of wallet \"default\": 1.5 ETH",
//   "balance": "1.5",
//   "wallet": "default"
// }