Base Network MCP Server

MIT License
4
1
  • Apple

Integrations

  • Allows interaction with the Base blockchain network (operated by Coinbase) for performing wallet management, balance checking, and transaction execution operations.

  • Provides specific configuration paths for Claude Desktop integration on macOS systems.

servidor mcp de red base

Este es un servidor MCP para la red Base. Permite a los LLM realizar operaciones de blockchain en la red Base mediante comandos de lenguaje natural, incluyendo la gestión de billeteras, la consulta de saldos y la ejecución de transacciones.

Este servidor funciona tanto con Base Mainnet como con Base Sepolia testnet.

Herramientas

Las siguientes herramientas están disponibles:

comando_de_proceso

Procesa un comando en lenguaje natural para operaciones de red base. Acepta los siguientes argumentos:

  • command : El comando en lenguaje natural a procesar (por ejemplo, "Enviar 0,5 ETH a 0x1234...")

Devuelve una respuesta estructurada con el resultado de la operación, incluidos los detalles de la transacción para las operaciones de envío, información de saldo para las verificaciones de saldo y detalles de la billetera para la creación de la billetera.

crear_billetera

Crea una nueva billetera en la red Base. Acepta los siguientes argumentos:

  • name : (opcional) Un nombre para la billetera

Devuelve un objeto que contiene la dirección de la billetera, el nombre y otros detalles.

comprobar_saldo

Consulta el saldo de una billetera en la red Base. Acepta los siguientes argumentos:

  • wallet : (opcional) El nombre o la dirección de la billetera que se verificará (por defecto, la billetera principal)

Devuelve el saldo de la billetera en ETH.

lista_de_carteras

Enumera todas las billeteras disponibles.

Devuelve una matriz de objetos de billetera, cada uno de los cuales contiene la dirección de la billetera, el nombre y otros detalles.

Uso

Con Claude Desktop

Claude Desktop es un popular cliente LLM compatible con el Protocolo de Contexto de Modelo. Puedes conectar tu servidor Base MCP a Claude Desktop para realizar operaciones de blockchain mediante comandos de lenguaje natural.

Puede agregar servidores MCP a Claude Desktop a través de su archivo de configuración en:

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

Para agregar su servidor Base MCP a Claude Desktop, agregue la siguiente configuración al objeto mcpServers en el archivo de configuración:

{ "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": [] } } }

Configuración

  • BASE_PROVIDER_URL : La URL del proveedor de red base (Mainnet o Sepolia)
  • WALLET_PRIVATE_KEY : Su clave privada de billetera para autenticación y firma de transacciones
  • DEFAULT_GAS_PRICE : (Opcional) Precio del gas predeterminado en Gwei

Programáticamente (cliente MCP personalizado)

Si está creando su propio cliente MCP, puede conectarse al servidor Base MCP mediante programación usando su transporte preferido. El SDK de MCP ofrece transportes stdio y SSE integrados.

Instalación

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

Ejemplo

El siguiente ejemplo utiliza StreamTransport para conectar directamente un cliente y un servidor 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" // }

Comandos de ejemplo

Una vez integrado, puedes utilizar comandos en lenguaje natural como:

  • "Crea una nueva billetera para tus ahorros"
  • "Consulta el saldo de mi billetera"
  • ¿Cuál es el saldo de mi billetera de ahorros?
  • "Enviar 0.1 ETH a 0x1234567890123456789012345678901234567890"
  • "Transfiere 0,5 ETH de mi billetera de ahorros a 0xABCD..."

Consideraciones de seguridad

Dado que esta implementación interactúa con redes blockchain reales y maneja claves privadas:

  1. Seguridad de clave privada : almacene las claves privadas de forma segura y nunca las envíe al control de versiones
  2. Utilice Testnet primero : comience con la red de prueba Base Sepolia antes de pasar a la red principal
  3. Validación de transacciones : Siempre valide los parámetros de la transacción antes de enviarla
  4. Manejo de errores : Implemente un manejo de errores robusto para problemas de red
  5. Limitación de velocidad : tenga en cuenta los límites de velocidad de la API al realizar solicitudes frecuentes

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

Un servidor MCP que permite a los LLM realizar operaciones de blockchain en la red Base a través de comandos de lenguaje natural, incluida la gestión de billeteras, la verificación de saldos y la ejecución de transacciones.

  1. Tools
    1. process_command
    2. create_wallet
    3. check_balance
    4. list_wallets
  2. Usage
    1. With Claude Desktop
    2. Configuration
    3. Programmatically (custom MCP client)
  3. Installation
    1. Example
      1. Example Commands
        1. Security Considerations
          ID: xx2sxvy29l