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 consultarkey(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 Crypto Wallet EVM
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-serverInstalar dependencias:
npm iConfigurar proveedores de Ethereum: Cree un archivo
.enven la raíz del proyecto con lo siguiente (opcional):
PROVIDER_URL=https://your-provider-url.com,https://your-backup-provider.comSi 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 publicSolució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.
Available Tools
8 toolscheck-availabilityA
Check if an ENS name is available for registration
Inputs: name (required).
get-all-recordsB
Get all available information for an ENS name
Inputs: name (required).
get-name-historyC
Get the history of an ENS name
Inputs: name (required).
get-registration-priceC
Get the price to register an ENS name
Inputs: name (required), duration.
get-subdomainsC
Get subdomains for an ENS name
Inputs: name (required).
get-text-recordC
Get a text record for an ENS name
Inputs: key (required), name (required).
resolve-nameB
Resolve an ENS name to an Ethereum address
Inputs: name (required).
reverse-lookupB
Get the ENS name for an Ethereum address
Inputs: address (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
Each tool has a clearly distinct purpose with no overlap: availability checks, retrieving records/history/price/subdomains/text, resolving names, and reverse lookups. The descriptions make it easy to differentiate between tools like 'get-all-records' (comprehensive info) and 'get-text-record' (specific record type).
The naming follows a consistent verb-object pattern with hyphens (e.g., 'check-availability', 'get-all-records'), except for 'reverse-lookup' which uses a different verb style. This minor deviation slightly reduces consistency, but the overall pattern remains highly readable and predictable.
With 8 tools, the count is well-scoped for an ENS server, covering key operations like checking availability, retrieving various data types, resolving addresses, and reverse lookups. Each tool earns its place without feeling excessive or insufficient for the domain.
The toolset provides strong coverage for querying and resolving ENS names, including availability, records, history, price, subdomains, text records, and bidirectional resolution. A minor gap is the lack of write operations (e.g., registering or updating names), but the read-focused surface is nearly complete for its apparent purpose.
Maintenance
Related MCP Connectors
ENS names: resolve, read profiles and ownership, list names, prepare registrations and changes
44 MCP tools to search, value, register, trade, and manage ENS names. AI-powered intelligence layer.
EVM chain reads for agents: balances, gas, fees, blocks, txs, logs, ENS. 15 tools, x402 per call.
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables Claude to interact with Ethereum nodes, allowing users to check ENS token balances, view smart contract code, and decode transactions through natural language.51MIT
- AlicenseBqualityDmaintenanceProvides Claude with access to Ethereum and EVM-compatible blockchain operations, enabling wallet management, transaction handling, contract interactions, and blockchain queries through natural language.35136 npm10MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI assistants to interact with the Ethereum Name Service via natural language, supporting lookups, availability checks, pricing, subnames, and onchain records.15Apache 2.0
- AlicenseAqualityDmaintenanceAI-powered ENS intelligence for autonomous agents, enabling search, valuation, trading, and management of ENS domains via the Model Context Protocol.44AGPL 3.0