ENS MCP Server
ENS MCP 서버
클로드가 ENS 시스템과 상호 작용하여 이름을 확인하고, 가용성을 확인하고, 레코드를 검색하는 등의 작업을 수행할 수 있도록 하는 Ethereum 이름 서비스(ENS)용 MCP 서버입니다.
npm 패키지: https://www.npmjs.com/package/mcp-server-ens
도구
해결 이름
ENS 이름을 Ethereum 주소로 변환
필수 입력 사항:
name(문자열): 확인할 ENS 이름(예: 'vitalik.eth')
반환: 해당 Ethereum 주소 또는 오류 메시지
역방향 조회
Ethereum 주소에 대한 ENS 이름을 가져옵니다.
필수 입력 사항:
address(문자열): 조회할 Ethereum 주소
반환: 해당 ENS 이름 또는 이름을 찾을 수 없음을 나타냅니다.
텍스트 레코드 가져오기
ENS 이름에 대한 텍스트 레코드 가져오기
필수 입력 사항:
name(문자열): 쿼리할 ENS 이름key(문자열): 조회할 레코드 키(예: '이메일', 'url', '아바타', '설명', 'twitter' 등)
반환: 지정된 텍스트 레코드의 값 또는 레코드를 찾을 수 없음을 나타냅니다.
예약 가능 여부 확인
ENS 이름을 등록할 수 있는지 확인하세요
필수 입력 사항:
name(문자열): 확인할 ENS 이름
반환: 등록된 경우 가용성 상태 및 소유자 정보
모든 레코드 가져오기
ENS 이름에 대한 모든 사용 가능한 정보를 얻으세요
필수 입력 사항:
name(문자열): 쿼리할 ENS 이름
반환: 확인자 주소, 텍스트 레코드, 주소, 콘텐츠 해시, 소유권 및 만료 세부 정보를 포함한 포괄적인 정보
하위 도메인 가져오기
ENS 이름에 대한 하위 도메인 가져오기
필수 입력 사항:
name(문자열): 하위 도메인을 쿼리할 ENS 이름
반환: 소유자 정보가 포함된 하위 도메인 목록
get-name-history
ENS 이름의 역사를 알아보세요
필수 입력 사항:
name(문자열): 기록을 확인할 ENS 이름
반환: 전송, 확인자 변경 및 등록 이벤트를 포함한 이름과 관련된 기록 이벤트
등록 가격 받기
ENS 이름 등록 가격을 알아보세요
필수 입력 사항:
name(문자열): 가격을 확인할 ENS 이름
선택 입력 사항:
duration(숫자, 기본값: 1): 등록 기간(년)
반환: 기본 가격, 프리미엄 및 총액을 포함한 등록 가격 세부 정보
Related MCP server: MCP Crypto Wallet EVM
설정
필수 조건
Node.js(v16 이상)
npm 또는 yarn
Ethereum RPC 공급자(공개 또는 비공개)에 대한 액세스
설치
저장소를 복제하거나 새 프로젝트를 만듭니다.
지엑스피1
종속성 설치:
npm iEthereum 공급자 구성: 다음 내용을 포함하여 프로젝트 루트에
.env파일을 만듭니다(선택 사항):
PROVIDER_URL=https://your-provider-url.com,https://your-backup-provider.com공급자가 지정되지 않으면 서버는 다음 기본값을 사용합니다.
Claude Desktop과 함께 사용
claude_desktop_config.json 에 다음을 추가하세요.
npx 사용하기
{
"mcpServers": {
"ens": {
"command": "npx",
"args": [
"-y",
"mcp-server-ens"
],
"env": {
"PROVIDER_URL": "https://your-provider-url.com,https://your-backup-provider.com"
}
}
}
}로컬 스크립트 사용
{
"mcpServers": {
"ens": {
"command": "node",
"args": [
"/path/to/your/server.js"
],
"env": {
"PROVIDER_URL": "https://your-provider-url.com,https://your-backup-provider.com"
}
}
}
}오류 처리
서버는 다양한 시나리오에 대해 강력한 오류 처리를 구현합니다.
Ethereum 공급자에 연결하는 동안 네트워크 오류가 발생했습니다.
잘못된 ENS 이름 또는 Ethereum 주소
ENS 관련 오류
일반적인 운영 오류
모든 오류는 디버깅을 위한 기술적 세부 정보를 보존하면서 사용자 친화적인 메시지로 정규화됩니다.
출판
npm 패키지로 게시하려면:
npm publish --access public문제 해결
오류가 발생하는 경우:
Ethereum 공급자가 작동하고 액세스 가능한지 확인하세요.
쿼리하는 ENS 이름이 올바르게 형식화되어 있는지 확인하세요.
ENS 라이브러리의 최신 버전이 있는지 확인하세요.
PROVIDER_URL 환경 변수에서 여러 공급자를 쉼표로 구분하여 사용해 보세요.
특허
이 MCP 서버는 MIT 라이선스에 따라 라이선스가 부여됩니다. 즉, MIT 라이선스의 조건에 따라 소프트웨어를 자유롭게 사용, 수정 및 배포할 수 있습니다. 자세한 내용은 프로젝트 저장소의 LICENSE 파일을 참조하세요.
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