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

Instalación

Inicio rápido

Iniciando el servidor

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

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 )