MCP Etherscan 서버

Etherscan API를 통해 이더리움 블록체인 데이터 도구를 제공하는 MCP(Model Context Protocol) 서버입니다. ETH 잔액 확인, 거래 내역 조회, ERC20 이체 추적, 컨트랙트 ABI 가져오기, 가스 가격 모니터링, ENS 이름 확인 등의 기능을 제공합니다.

특징

• 잔액 확인 : 모든 이더리움 주소에 대한 ETH 잔액을 확인하세요
• 거래 내역 : 최근 거래 내역을 자세한 정보와 함께 확인하세요
• 토큰 전송 : 토큰 세부 정보를 사용하여 ERC20 토큰 전송을 추적하세요
• 계약 ABI : 개발을 위한 스마트 계약 ABI 가져오기
• 가스 가격 : 현재 가스 가격(안전 저가, 표준, 빠름)을 모니터링하세요
• ENS 해결 : Ethereum 주소를 ENS 이름으로 해결

필수 조건

• 노드.js >= 18
• Etherscan API 키( https://etherscan.io/apis 에서 받으세요)

설치

1. 저장소를 복제합니다.

지엑스피1

2. 종속성 설치:

3. 루트 디렉토리에 .env 파일을 만듭니다.

4. 프로젝트를 빌드하세요:

서버 실행

서버를 시작합니다:

서버는 stdio에서 실행되므로 Claude Desktop과 같은 MCP 클라이언트와 호환됩니다.

작동 원리

이 서버는 Etherscan API를 통해 이더리움 블록체인 데이터와 상호작용하는 도구를 제공하기 위해 모델 컨텍스트 프로토콜(MCP)을 구현합니다. 각 도구는 호환되는 클라이언트에서 호출할 수 있는 MCP 엔드포인트로 제공됩니다.

사용 가능한 도구

1. check-balance
   • 입력: 이더리움 주소
   • 출력: Wei와 ETH 모두의 ETH 잔액
2. get-transactions
   • 입력: 이더리움 주소, 선택적인 제한
   • 출력: 타임스탬프, 값 및 주소가 포함된 최근 거래
3. get-token-transfers
   • 입력: 이더리움 주소, 선택적인 제한
   • 출력: 토큰 세부 정보가 포함된 최근 ERC20 토큰 전송
4. get-contract-abi
   • 입력: 계약 주소
   • 출력: JSON 형식의 계약 ABI
5. get-gas-prices
   • 입력: 없음
   • 출력: Gwei의 현재 가스 가격
6. get-ens-name
   • 입력: 이더리움 주소
   • 출력: 사용 가능한 경우 연관된 ENS 이름

Claude Desktop과 함께 사용

Claude Desktop에 이 서버를 추가하려면:

1. npm start 사용하여 서버를 시작합니다.
2. Claude Desktop에서:
   • 설정으로 이동
   • MCP 서버 섹션으로 이동
   • "서버 추가"를 클릭하세요
   • 다음 구성을 입력하세요.
     { "name": "Etherscan Tools", "transport": "stdio", "command": "node /path/to/mcp-etherscan-server/build/index.js" }
   • 구성을 저장합니다
3. 이제 Claude 대화에서 Etherscan 도구를 사용할 수 있습니다.

Claude에서의 사용 예

다음과 같은 명령을 사용할 수 있습니다.

또는

개발

새로운 기능을 추가하거나 기존 기능을 수정하려면:

1. 메인 서버 로직은 src/server.ts 에 있습니다.
2. Etherscan API 상호 작용은 src/services/etherscanService.ts 에서 처리됩니다.
3. 변경 후 빌드: npm run build

특허

MIT 라이선스 - 자세한 내용은 라이선스 파일을 참조하세요.