MCP Web3

Un servidor de Modelo-Contexto-Protocolo para interactuar con múltiples cadenas de bloques, incluyendo Solana, Ethereum, THORChain, XRP Ledger, TON (The Open Network), Cardano y cadenas UTXO. Este servidor proporciona puntos finales RPC simples para operaciones comunes de cadena de bloques, lo que permite interacciones seguras con diversas cadenas de bloques mediante variables de entorno.

Características

Operaciones de Solana:

• Consultar saldos de cuentas SOL
• Obtenga información detallada de la cuenta
• Transferir SOL entre cuentas
• Ver saldos de tokens SPL
• Obtenga la dirección de su billetera a partir de la clave privada
• Intercambia tokens usando Jupiter (mejor ruta de precios en todos los DEX de Solana)

Operaciones de la cadena Ethereum y EVM:

• Consultar los saldos de tokens nativos en múltiples redes
• Consultar saldos de tokens ERC-20
• Enviar tokens nativos (usando la clave privada de .env)
• Enviar tokens ERC-20 (usando la clave privada de .env)
• Aprobar el gasto del token ERC-20 (utilizando la clave privada de .env)

Operaciones de Cardano:

• Obtener información y estadísticas de la red
• Consultar saldos de direcciones e historial de transacciones
• Ver UTxO para una dirección
• Explorar los grupos de participación y la información de delegación
• Obtenga detalles sobre los activos nativos
• Ver información detallada de la transacción
• Obtener estadísticas sobre la época actual

Operaciones de THORChain:

• Consultar saldos de RUNE
• Obtenga información detallada sobre la piscina
• Obtenga cotizaciones de intercambio entre cualquier activo compatible
• Intercambios entre cadenas a través del protocolo THORChain

Operaciones de la cadena UTXO:

• Bitcoin (BTC)
  • Consultar saldos de direcciones
  • Ver historial de transacciones
  • Validar direcciones
  • Obtenga información y tarifas de la red
• Litecoin (LTC)
  • Consultar saldos de direcciones
  • Ver historial de transacciones
  • Validar direcciones
  • Obtenga información y tarifas de la red
• Dogecoin (DOGE)
  • Consultar saldos de direcciones
  • Ver historial de transacciones
  • Validar direcciones
  • Obtenga información y tarifas de la red
• Bitcoin Cash (BCH)
  • Consultar saldos de direcciones
  • Ver historial de transacciones
  • Validar direcciones
  • Obtenga información y tarifas de la red

Operaciones del libro mayor de XRP:

• Consultar saldos de cuentas XRP
• Ver historial de transacciones
• Validar direcciones XRP
• Enviar XRP a otra dirección
• Obtenga información actualizada sobre XRP Ledger
• Consultar saldos de tokens
• Crear líneas de confianza para tokens

Operaciones de TON (La Red Abierta):

• Obtenga los saldos de las cuentas TON
• Ver historial de transacciones
• Validar direcciones TON
• Enviar TON a otra dirección con nota/comentario opcional
• Obtenga información actualizada de la red TON

Redes EVM compatibles:

• Ethereum
• Base
• Arbitrum
• Optimismo
• BSC (Cadena inteligente de Binance)
• Polígono
• Avalancha
• Berachain

Configuración

1. Clonar e instalar dependencias:

2. Cree un archivo .env en el directorio raíz:

3. Configure sus variables de entorno en .env:

Configuración requerida

Configuración opcional

4. Construir la herramienta:

5. Añade la herramienta a tu claude_desktop_config.json:

Registro de herramientas

El servidor Web3 MCP le permite controlar qué herramientas de blockchain se registran a través de variables de entorno:

• ENABLE_SOLANA_TOOLS : Habilitar/deshabilitar las herramientas de Solana
• ENABLE_ETHEREUM_TOOLS : Habilitar o deshabilitar las herramientas de la cadena Ethereum y EVM
• ENABLE_BITCOIN_TOOLS : Habilitar/deshabilitar herramientas de Bitcoin
• ENABLE_LITECOIN_TOOLS : Habilitar/deshabilitar herramientas de Litecoin
• ENABLE_DOGECOIN_TOOLS : Habilitar/deshabilitar herramientas de Dogecoin
• ENABLE_BITCOINCASH_TOOLS : Habilitar/deshabilitar herramientas de Bitcoin Cash
• ENABLE_THORCHAIN_TOOLS : Habilitar/deshabilitar herramientas THORChain
• ENABLE_RIPPLE_TOOLS : Habilitar/deshabilitar las herramientas de XRP Ledger
• ENABLE_CARDANO_TOOLS : Habilitar/deshabilitar las herramientas de Cardano
• ENABLE_TON_TOOLS : Habilitar/deshabilitar herramientas TON

Establezca estas variables como true o false en su archivo .env para controlar qué herramientas están disponibles para el servidor. Esto le permite:

• Reduzca el tiempo de inicio cargando solo las herramientas necesarias
• Minimizar la superficie de seguridad desactivando las cadenas no utilizadas
• Personalice el servidor para casos de uso específicos
• Controle el uso de recursos limitando las conexiones activas

Ejemplos de uso

Pregúntele a Claude (o al cliente MCP que prefiera):

Operaciones de Solana (cuando ENABLE_SOLANA_TOOLS=true)

• "¿Cuál es mi dirección de Solana?" - Muestra tu dirección derivada de la clave privada en .env
• "¿Cuál es el saldo de 62QXuWZ3WT6ws1ZFxJobVDVXn6bEsiYpLo5yG612U6u3?"
• "Transferir 0,001 SOL a Cg6cVS4tjkxHthm3K9BHhmvqF7kSz8GnXqqYXnHBzGXd"
• "Muéstrame el saldo de mis tokens SPL"
• Intercambio de 0,1 SOL a USDC (utiliza Jupiter para optimizar el enrutamiento de precios)

Operaciones EVM (cuando ENABLE_ETHEREUM_TOOLS=true)

• "¿Cuál es el saldo de ETH de 0x556437c4d22ceaeeebf82006b85bdcc0ae67d933?"
• Consulta el saldo de USDC para 0x556437c4d22ceaeeebf82006b85bdcc0ae67d933 en Ethereum.
• "Envía 0,1 ETH a 0x556437c4d22ceaeeebf82006b85bdcc0ae67d933"
• "¿Cuál es el precio actual de la gasolina en Arbitrum?"
• Envía 100 USDC a 0x556437c4d22ceaeeebf82006b85bdcc0ae67d933 en Polygon.

Operaciones de Cardano (cuando ENABLE_CARDANO_TOOLS=true)

• Obtenga el saldo de cualquier Cardano
• Ver la información de su billetera
• Enviar ADA a otra dirección
• Enviar tokens nativos a otra dirección

Operaciones de Bitcoin (cuando ENABLE_BITCOIN_TOOLS=true)

• "¿Cuál es el saldo de BTC de 1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa?"
• Muéstrame el historial de transacciones de bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh
• Validar esta dirección de Bitcoin: 1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa

Operaciones de Litecoin (cuando ENABLE_LITECOIN_TOOLS=true)

• "¿Cuál es el balance LTC de LM2WMpR1Rp6j3Sa59cMXMs1SPzj9eXpGc1?"
• "Muéstrame el historial de transacciones de esta dirección de Litecoin"
• "¿Cuál es la tarifa actual de la red Litecoin?"

Operaciones de Dogecoin (cuando ENABLE_DOGECOIN_TOOLS=true)

• Consulta el saldo de esta dirección DOGE: D8vFz4p1L37jdg47HXKtSHA5uYLYxbGgPD
• "Muéstrame transacciones recientes de Dogecoin"
• "¿Cuáles son las tarifas actuales de la red DOGE?"

Operaciones de Bitcoin Cash (cuando ENABLE_BITCOINCASH_TOOLS=true)

• "¿Cuál es el saldo BCH de esta dirección?"
• "Muéstrame el historial de transacciones del BCH"
• Validar esta dirección de Bitcoin Cash

Operaciones de THORChain (cuando ENABLE_THORCHAIN_TOOLS=true)

• "¿Cuál es el saldo de RUNE de thor13zpdckczd0jvyhwxmrwnpap8gmy9m5kk2gzum3?"
• "Muéstrame la información del pool de BTC.BTC"
• Obtén una cotización de intercambio de 0,1 BTC a ETH.ETH.

Operaciones contables de XRP (cuando ENABLE_RIPPLE_TOOLS=true)

• "¿Cuál es el saldo de XRP de rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe?"
• "Muéstrame el historial de transacciones de rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe"
• "¿Es rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe una dirección XRP válida?"
• Envía 10 XRP a rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe
• "¿Cuál es la información actual del XRP Ledger?"
• Muéstrame los saldos de tokens de rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe
• Crear una línea de confianza para USD con el emisor rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe con un límite de 1000.

Operaciones TON (cuando ENABLE_TON_TOOLS=true)

• "¿Cuál es el saldo de TON de EQAAFhjXzKuQ5N0c96nsdZQWATcJm909LYSaCAvWFQF8tvUZ?"
• Muéstrame el historial de transacciones de EQAAFhjXzKuQ5N0c96nsdZQWATcJm909LYSaCAvWFQF8tvUZ
• "¿Es UQD0BRQt-QdIEbsjuRsMqzDlBkUAEfQixShDECoKEOXRc4eR una dirección TON válida?"
• "Enviar 0,1 TONELADAS a EQAAFhjXzKuQ5N0c96nsdZQWATcJm909LYSaCAvWFQF8tvUZ"
• Enviar 0,01 TON a UQD0BRQt-QdIEbsjuRsMqzDlBkUAEfQixShDECoKEOXRc4eR con el comentario 'pago de prueba'
• "¿Cuál es la información actual de la red TON?"

Notas de seguridad

1. Variables de entorno : todas las claves privadas se almacenan en el archivo .env y nunca se exponen en el historial de conversaciones
2. Claves privadas : use esto solo con billeteras de prueba que contengan pequeñas cantidades de fondos
3. Puntos finales de RPC : se pueden configurar puntos finales de RPC personalizados en el archivo .env para una mejor confiabilidad y límites de velocidad
4. Seguridad .env : Git ignora automáticamente el archivo .env para evitar la exposición accidental de claves privadas
5. Registro de herramientas : utilice los controles de registro de herramientas para minimizar el área de superficie de seguridad al habilitar solo las cadenas requeridas

Configuración avanzada

Puntos finales de RPC personalizados

Puede configurar puntos finales RPC personalizados en su archivo .env para una mayor confiabilidad y límites de velocidad más altos. Si no se especifica, la herramienta recurrirá a puntos finales RPC públicos.

Selección de red

Para las operaciones de EVM, puede especificar la red por nombre (Ethereum, Base, Arbitrum, Optimism, BSC, Polygon, Avalanche, Berachain). La herramienta utilizará automáticamente el punto final RPC y la configuración de red adecuados.

Configuración de Cardano

La herramienta utiliza la API de Blockfrost y la biblioteca Lucid para interactuar con la cadena de bloques Cardano.

• BLOCKFROST_API_KEY : Obligatorio: su clave API de Blockfrost (regístrese en https://blockfrost.io/ )
• CARDANO_NETWORK : Opcional: La red Cardano que se usará (red principal, red de prueba, vista previa, preproducción). El valor predeterminado es 'red principal'.
• CARDANO_MNEMONIC : Requerido para transacciones: la frase mnemotécnica de su billetera Cardano (15 o 24 palabras)
• CARDANO_ACCOUNT_INDEX : Opcional: el índice de cuenta a utilizar (predeterminado 0)

La billetera derivada de su mnemónico se utilizará para firmar y enviar transacciones.

Configuración de THORChain

La herramienta utiliza puntos finales públicos de Nine Realms de manera predeterminada, pero puedes configurar una URL de nodo THORChain personalizada en el archivo .env para obtener mejor confiabilidad y límites de velocidad.

Configuración del libro mayor de XRP

La herramienta puede usar una clave privada o una frase mnemotécnica para las transacciones de XRP. Configúrelas en su archivo .env:

• XRP_PRIVATE_KEY : Su clave privada XRP en formato hexadecimal
• XRP_MNEMONIC : Alternativa a la clave privada: su frase de recuperación de 12 palabras
• XRP_ADDRESS : Opcional: la dirección de su cuenta XRP (se utiliza para verificar la dirección derivada)
• XRP_RPC_URL : Opcional: URL de nodo de XRP Ledger personalizada (predeterminada al punto final público)

Configuración de TON

La herramienta utiliza la API de TON Center por defecto y requiere una frase mnemotécnica para las transacciones TON. Configúrela en su archivo .env:

• TON_MNEMONIC : Obligatorio: su frase de recuperación de 24 palabras para la billetera TON
• TON_ADDRESS : Obligatorio: la dirección de su billetera TON
• TON_API_KEY : Recomendado: clave API de @tonapibot en Telegram (para límites de velocidad más altos)
• TON_RPC_URL : Opcional: URL de RPC de TON personalizada (predeterminada en la API del Centro TON)

La implementación incluye lógica de reintento automático con retroceso exponencial para el manejo del límite de velocidad.

Proveedores de datos de la cadena UTXO

La herramienta utiliza varios proveedores de datos para cadenas UTXO:

• Cifrado de bloque
• SoChain
• Haskoin (para Bitcoin Cash)

Puede configurar claves API para estos proveedores en el archivo .env para obtener mejores límites de velocidad.

Desarrollo

Para modificar o ampliar la herramienta:

1. El código fuente está en el directorio src
2. Código específico de la cadena en src/chains
3. Ejecute npm run build después de realizar cambios
4. Utilice TypeScript para todo el código nuevo

Contribuyendo

¡Agradecemos sus contribuciones! Envíen solicitudes de incorporación de cambios con cualquier mejora o corrección de errores.

Licencia

Licencia ISC