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): 등록 기간(년)
반환: 기본 가격, 프리미엄 및 총액을 포함한 등록 가격 세부 정보

설정

필수 조건

Node.js(v16 이상)
npm 또는 yarn
Ethereum RPC 공급자(공개 또는 비공개)에 대한 액세스

설치

저장소를 복제하거나 새 프로젝트를 만듭니다.

지엑스피1

종속성 설치:

npm i

Ethereum 공급자 구성: 다음 내용을 포함하여 프로젝트 루트에 .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 파일을 참조하세요.

ENS MCP Server

Integrations