Monedero MCP Ethers

Un servidor de Protocolo de Contexto de Modelo para interactuar con monederos y redes de Ethereum mediante Ethers.js v6. Este servidor proporciona a los LLM una interfaz estandarizada para interactuar con redes, contratos inteligentes y monederos de Ethereum.

Descripción general

El servidor MCP Ethers Wallet implementa la especificación del Protocolo de contexto de modelo , lo que proporciona a los LLM herramientas para:

• Consultar datos de blockchain en múltiples redes

• Interactuar con contratos inteligentes

• Administrar operaciones de billetera

• Resolver nombres de ENS

• Gestionar transacciones

• Estimar los costos del gas

Related MCP server: EVM MCP Server

Instalación

npm install mcp-ethers-wallet

Inicio rápido

Iniciando el servidor

import { startServer } from 'mcp-ethers-wallet';

startServer().catch((error) => {
  console.error('Failed to start server:', error);
  process.exit(1);
});

Uso con Claude Desktop

1. Instalar Claude Desktop

2. Agregue un nuevo servidor MCP con la siguiente configuración:

    "ethers": {
      "command": "node",
      "args": [
        "/path-to-mcp-ethers-wallet/build/src/index.js"
      ],
      "env": {
        "ALCHEMY_API_KEY": "<<your alchemy api key>>"
      }
    }

3. Las herramientas ahora estarán disponibles en tus conversaciones de Claude

Pruebas con MCP Inspector

1. Instalar el Inspector MCP:

   npm install -g @modelcontextprotocol/inspector

2. Iniciar el servidor:

   npm start

3. En otra terminal, ejecute el inspector:

   mcp-inspector

4. Abra http://localhost:5173 en su navegador para interactuar con las herramientas

Herramientas disponibles

Información de la red

• getSupportedNetworks : Obtenga una lista de todas las redes compatibles y sus configuraciones

• getBlockNumber : obtiene el número de bloque actual de una red

• getBlockDetails : Obtenga información detallada sobre un bloque específico

• getGasPrice : Obtenga el precio actual del gas

• getFeeData : Obtenga datos detallados de tarifas, incluida la tarifa base y la tarifa prioritaria

Operaciones de billetera

• checkWalletExists : Comprueba si una billetera está configurada (sin exponer claves privadas)

• getWalletBalance : obtiene el saldo del token nativo de una billetera

• getWalletTransactionCount : obtiene la cantidad de transacciones enviadas desde una billetera

• getERC20Balance : Obtenga el saldo de un token ERC20 para una billetera

Gestión de transacciones

• getTransactionDetails : Obtenga información detallada sobre una transacción

• sendTransaction : envía una transacción de token nativa

• sendTransactionWithOptions : envía una transacción con opciones personalizadas (gas, nonce, etc.)

• getTransactionsByBlock : obtiene todas las transacciones en un bloque específico

Interacción de contratos inteligentes

• contractCall : ejecuta un método de escritura de contrato

• contractCallView : Ejecuta un método de lectura de contrato

• getContractCode : obtiene el código de bytes de un contrato implementado

Operaciones ENS

• lookupAddress : resuelve un nombre ENS en una dirección

• resolveName : Resolver una dirección a un nombre ENS

Soporte de red

El servidor admite múltiples redes, incluidas:

• Red principal de Ethereum

• PoS de polígono

• Arbitrum

• Optimismo

• Base

• Y más...

Utilice la herramienta getSupportedNetworks para obtener una lista completa de redes compatibles.

Configuración

El servidor se puede configurar mediante variables de entorno:

• ALCHEMY_API_KEY : Su clave API de Alchemy para acceso a la red

• PRIVATE_KEY : Clave privada para la firma de transacciones (opcional)

• DEFAULT_NETWORK : Red predeterminada a utilizar (predeterminada a "mainnet")

Manejo de errores

El servidor proporciona mensajes de error detallados para problemas comunes:

• Nombres de red o URL de RPC no válidos

• Desajustes de ID de cadena

• Fallas en la interacción del contrato

• Errores de transacción

• Problemas de conectividad de red

Desarrollo

# Install dependencies
npm install

# Run tests
npm test

# Start in development mode
npm run dev

# Build
npm run build

Contribuyendo

Los problemas y las solicitudes de extracción son bienvenidos en GitHub.

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

Autor

Dennison Bertram ( dennison@tally.xyz )