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

Clonar el repositorio o crear un nuevo proyecto:

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

Instalar dependencias:

npm i

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:

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.

ENS MCP Server

Integrations