ENS MCP Server

Servidor ENS MCP

Servidor MCP para Ethereum Name Service (ENS), que permite a Claude interactuar con el sistema ENS para resolver nombres, verificar disponibilidad, recuperar registros y más.

Paquete npm: https://www.npmjs.com/package/mcp-server-ens

Herramientas

resolver-nombre

Resolver un nombre ENS en una dirección Ethereum

• Entradas requeridas:
  • name (cadena): el nombre de ENS a resolver (por ejemplo, 'vitalik.eth')
• Devuelve: La dirección de Ethereum correspondiente o un mensaje de error

búsqueda inversa

Obtenga el nombre ENS para una dirección de Ethereum

• Entradas requeridas:
  • address (cadena): la dirección de Ethereum que se buscará
• Devuelve: El nombre ENS correspondiente o una indicación de que no se encontró ningún nombre

obtener registro de texto

Obtener un registro de texto para un nombre ENS

• Entradas requeridas:
  • name (cadena): el nombre de la ENS a consultar
  • key (cadena): la clave del registro para buscar (por ejemplo, 'correo electrónico', 'URL', 'avatar', 'descripción', 'twitter', etc.)
• Devuelve: El valor del registro de texto especificado o la indicación de que no se encontró ningún registro

comprobar disponibilidad

Compruebe si un nombre ENS está disponible para el registro

• Entradas requeridas:
  • name (cadena): el nombre de la ENS a comprobar
• Devoluciones: Estado de disponibilidad e información del propietario si está registrado

obtener todos los registros

Obtenga toda la información disponible para un nombre ENS

• Entradas requeridas:
  • name (cadena): el nombre de la ENS a consultar
• Devoluciones: información completa que incluye dirección de resolución, registros de texto, direcciones, hash de contenido, propiedad y detalles de vencimiento

obtener subdominios

Obtener subdominios para un nombre ENS

• Entradas requeridas:
  • name (cadena): el nombre de ENS para consultar subdominios
• Devuelve: Lista de subdominios con la información de su propietario

obtener historial de nombres

Obtener el historial de un nombre ENS

• Entradas requeridas:
  • name (cadena): el nombre de la ENS para consultar el historial
• Devoluciones: eventos históricos relacionados con el nombre, incluidas transferencias, cambios de resolución y eventos de registro

obtener-precio-de-registro

Obtenga el precio para registrar un nombre ENS

• Entradas requeridas:
  • name (cadena): el nombre de la ENS para la que se desea consultar el precio
• Entradas opcionales:
  • duration (número, predeterminado: 1): Duración del registro en años
• Devoluciones: Desglose del precio de registro que incluye precio base, prima y total

Configuración

Prerrequisitos

• Node.js (v16 o superior)
• npm o hilo
• Acceso a proveedores de RPC de Ethereum (públicos o privados)

Instalación

1. Clonar el repositorio o crear un nuevo proyecto:

2. Instalar dependencias:

3. Configurar proveedores de Ethereum: Cree un archivo .env en la raíz del proyecto con lo siguiente (opcional):

Si no se especifican proveedores, el servidor utilizará estos valores predeterminados:

• https://eth.drpc.org
• https://eth.llamarpc.com
• https://ethereum.publicnode.com
• https://rpc.ankr.com/eth

Uso con Claude Desktop

Agregue lo siguiente a su claude_desktop_config.json :

Usando npx

Usando script local

Manejo de errores

El servidor implementa un manejo robusto de errores para diversos escenarios:

• Errores de red al conectarse a los proveedores de Ethereum
• Nombres ENS o direcciones Ethereum no válidos
• Errores específicos de ENS
• Errores operativos generales

Todos los errores se normalizan en mensajes fáciles de usar, conservando al mismo tiempo los detalles técnicos para la depuración.

Publicación

Para publicar como un paquete npm:

Solución de problemas

Si encuentra errores:

• Verifique que sus proveedores de Ethereum funcionen y estén accesibles
• Comprueba que los nombres ENS que estás consultando estén formateados correctamente
• Asegúrese de tener la última versión de las bibliotecas ENS
• Intente utilizar varios proveedores separándolos con comas en la variable de entorno PROVIDER_URL

Licencia

Este servidor MCP cuenta con la licencia MIT. Esto significa que puede usar, modificar y distribuir el software libremente, sujeto a los términos y condiciones de la licencia MIT. Para más detalles, consulte el archivo de LICENCIA en el repositorio del proyecto.