Base Network MCP Server

基础网络mcp服务器

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

此服务器可与Base Mainnet和Base Sepolia testnet一起使用。

工具

以下工具可用：

进程命令

处理用于基础网络操作的自然语言命令。它接受以下论点：

• command：要处理的自然语言命令（例如，“向0x1234发送0.5 ETH…”）

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

创建钱包

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

• name：（可选）钱包的名称

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

检查平衡

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

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

它以ETH返回钱包余额。

list_wallets

列出所有可用的钱包。

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

用法

使用克劳德桌面

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

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

• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
• 窗户： %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：基础网络提供商（Mainnet或Sepolia）的URL
• WALLET_PRIVATE_KEY：用于身份验证和交易签名的钱包私钥
• DEFAULT_GAS_PRICE：（可选）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"
// }

示例命令

集成后，您可以使用自然语言命令，如：

• “创建一个新的钱包进行储蓄”
• “检查我的钱包余额”
• “我的储蓄钱包余额是多少？”
• “发送0.1 ETH到0x1234567890123456789012345678901234678901234567890”
• “将0.5 ETH从我的储蓄钱包转移到0xABCD…”

安全考虑

由于此实现与真实的区块链网络交互并处理私钥：

1. 私钥安全：安全地存储私钥，永远不要将其提交给版本控制
2. 先使用测试网：在迁移到主网之前，先从Base Sepolia测试网开始
3. 交易验证：发送前始终验证交易参数
4. 错误处理：对网络问题实施稳健的错误处理
5. 速率限制：频繁请求时要注意API速率限制