Monedero criptográfico MCP EVM

Este repositorio contiene un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona a Claude acceso a operaciones de blockchain compatibles con Ethereum y EVM a través de ethers.js v5. El servidor permite a Claude realizar operaciones como crear billeteras, consultar saldos, enviar transacciones e interactuar con contratos inteligentes en blockchains compatibles con EVM.

Descripción general

El servidor MCP expone las siguientes herramientas a Claude:

Creación y gestión de billeteras

• wallet_create_random : Crea una nueva billetera con una clave privada aleatoria
• wallet_from_private_key : Crea una billetera a partir de una clave privada
• wallet_from_mnemonic : Crea una billetera a partir de una frase mnemotécnica
• wallet_from_encrypted_json : Crea una billetera descifrando una billetera JSON cifrada
• wallet_encrypt : Cifrar una billetera con una contraseña

Propiedades de la billetera

• wallet_get_address : Obtener la dirección de la billetera
• wallet_get_public_key : Obtener la clave pública de la billetera
• wallet_get_private_key : obtiene la clave privada de la billetera (con las advertencias de seguridad apropiadas)
• wallet_get_mnemonic : Obtener la frase mnemotécnica de la billetera (si está disponible)

Métodos de blockchain

• wallet_get_balance : Obtener el saldo de la billetera
• wallet_get_chain_id : Obtiene el ID de la cadena a la que está conectada la billetera
• wallet_get_gas_price : Obtener el precio actual del gas
• wallet_get_transaction_count : Obtiene la cantidad de transacciones enviadas desde esta cuenta (nonce)
• wallet_call : Llamar a un método de contrato sin enviar una transacción

Métodos de transacción

• wallet_send_transaction : Enviar una transacción
• wallet_sign_transaction : Firmar una transacción sin enviarla
• wallet_populate_transaction : rellenar una transacción con campos faltantes

Métodos de firma

• wallet_sign_message : Firmar un mensaje
• wallet_sign_typed_data : Firma de datos tipificados (EIP-712)
• wallet_verify_message : Verificar un mensaje firmado
• wallet_verify_typed_data : Verificar datos tipificados y firmados

Métodos del proveedor

• provider_get_block : Obtener un bloque por número o hash
• provider_get_transaction : Obtener una transacción por hash
• provider_get_transaction_receipt : Obtener un recibo de transacción
• provider_get_code : Obtener el código en una dirección
• provider_get_storage_at : Obtener el almacenamiento en una posición para una dirección
• provider_estimate_gas : Estima el gas requerido para una transacción
• provider_get_logs : Obtener registros que coinciden con un filtro
• provider_get_ens_resolver : obtiene el solucionador ENS para un nombre
• provider_lookup_address : busca el nombre ENS de una dirección
• provider_resolve_name : Resolver un nombre ENS a una dirección

Métodos de red

• network_get_network : Obtener la información de la red actual
• network_get_block_number : Obtener el número de bloque actual
• network_get_fee_data : obtiene los datos de tarifa actuales (tarifa base, tarifa de prioridad máxima, etc.)

Prerrequisitos

• Node.js (v16 o superior)
• Aplicación de escritorio Claude

Instalación

Opción 1: Usar npx (recomendado)

Puede ejecutar el servidor MCP directamente sin instalación usando npx:

Esto descargará y ejecutará el servidor directamente desde npm.

Opción 2: Instalación manual

1. Clonar este repositorio:
   git clone https://github.com/dcSpark/mcp-cryptowallet-evm.git cd mcp-cryptowallet-evm
2. Instalar dependencias:
   npm ci
3. Construir el proyecto:
   npm run build

Configuración

Variables de entorno

El servidor MCP admite las siguientes variables de entorno:

• PRIVATE_KEY : Clave privada opcional para usar en operaciones de billetera cuando no se proporciona ninguna billetera explícitamente

Configurar Claude Desktop

Para configurar Claude Desktop para utilizar este servidor MCP:

1. Abra Claude Desktop
2. Navegue hasta el archivo de configuración de Claude Desktop:
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Ventanas: %APPDATA%\Claude\claude_desktop_config.json
   • Linux: ~/.config/Claude/claude_desktop_config.json
3. Agregue la configuración del servidor MCP:

Alternativamente, si instaló el paquete localmente:

Ejecutando localmente

Uso

Una vez configurado, reinicie Claude Desktop. Claude ahora tendrá acceso a las herramientas de blockchain compatibles con Ethereum y EVM. Puede pedirle a Claude que:

1. Crear una nueva billetera:
   Can you create a new Ethereum wallet for me?
2. Consultar el saldo de una billetera:
   What's the balance of the Ethereum wallet address 0x742d35Cc6634C0532925a3b844Bc454e4438f44e?
3. Enviar una transacción:
   Can you help me send 0.1 ETH to 0x742d35Cc6634C0532925a3b844Bc454e4438f44e?

Claude utilizará el servidor MCP para interactuar directamente con la cadena de bloques Ethereum.

Desarrollo

Agregar nuevas herramientas

Para agregar nuevas herramientas al servidor MCP:

1. Define la herramienta en src/tools.ts
2. Cree una función de controlador en el archivo de controlador apropiado
3. Agregue el controlador al objeto de handlers en src/tools.ts

Edificio

Licencia

Instituto Tecnológico de Massachusetts (MIT)