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

Related MCP server: MCP Etherscan Server

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:

git clone https://github.com/JustaName-id/ens-mcp-server

2. Instalar dependencias:

npm i

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

PROVIDER_URL=https://your-provider-url.com,https://your-backup-provider.com

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

{
  "mcpServers": {
    "ens": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-ens"
      ],
      "env": {
        "PROVIDER_URL": "https://your-provider-url.com,https://your-backup-provider.com"
      }
    }
  }
}

Usando script local

{
  "mcpServers": {
    "ens": {
      "command": "node",
      "args": [
        "/path/to/your/server.js"
      ],
      "env": {
        "PROVIDER_URL": "https://your-provider-url.com,https://your-backup-provider.com"
      }
    }
  }
}

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:

npm publish --access public

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.