MCP 문서 관리

메뉴

홈
문서 목록
관리자 로그인

문서 정보

최종 수정일:
2025-05-13 10:50
태그:
#MCP #써드파티 #블록체인 #Web3 #이더리움

EVM

EVM

EVM MCP 서버는 이더리움 가상 머신(Ethereum Virtual Machine) 호환 네트워크와 상호작용하기 위한 포괄적인 도구를 제공하는 MCP 서버입니다. 30개 이상의 EVM 호환 블록체인 네트워크에서 블록체인 데이터 읽기, 스마트 계약 상호작용, 토큰 전송 등의 기능을 단일 인터페이스를 통해 AI 에이전트에게 제공합니다.

특징

  • 멀티체인 지원: 이더리움, 옵티미즘, 아비트럼, 폴리곤 등 30개 이상의 EVM 호환 네트워크 지원
  • ENS 이름 해석: 주소 대신 'vitalik.eth'와 같은 사람이 읽을 수 있는 이름을 사용할 수 있는 ENS 이름 해석 기능
  • 블록체인 상태 읽기: 잔액, 트랜잭션, 블록 등 블록체인 상태 정보 조회
  • 스마트 계약 상호작용: ABI를 통한 스마트 계약 함수 호출 및 데이터 읽기
  • 토큰 관리: ERC20, ERC721, ERC1155 표준 토큰 전송 및 잔액 조회
  • 트랜잭션 지원: 오류 처리 및 가스 추정이 포함된 포괄적인 트랜잭션 지원
  • 일관된 인터페이스: 모든 블록체인 기능에 대한 일관된 MCP 도구 및 리소스 인터페이스

API

리소스

  • 체인 정보: 블록 번호, 체인 ID, RPC 등 지원되는 체인에 대한 정보
  • 블록체인 데이터: 블록, 트랜잭션, 계정 잔액 등의 블록체인 데이터
  • 토큰 메타데이터: ERC20, ERC721, ERC1155 토큰의 메타데이터 정보

도구

블록체인 조회 도구

  • get_balance: 주소의 ETH 잔액을 조회합니다.
  • 입력: 주소(ENS 이름 지원), 체인 ID

  • 출력: ETH 잔액(wei 단위)

  • get_transaction: 트랜잭션 해시로 트랜잭션 정보를 조회합니다.

  • 입력: 트랜잭션 해시, 체인 ID

  • 출력: 트랜잭션 세부 정보

  • get_block: 블록 번호나 해시로 블록 정보를 조회합니다.

  • 입력: 블록 번호 또는 해시, 체인 ID
  • 출력: 블록 세부 정보

토큰 관리 도구

  • get_token_balance: ERC20 토큰 잔액을 조회합니다.
  • 입력: 주소(ENS 이름 지원), 토큰 계약 주소, 체인 ID

  • 출력: 토큰 잔액 및 메타데이터

  • transfer_token: ERC20 토큰을 전송합니다.

  • 입력: 수신자 주소(ENS 이름 지원), 토큰 계약 주소, 금액, 체인 ID

  • 출력: 트랜잭션 해시 및 상태

  • get_nft_balance: ERC721 또는 ERC1155 NFT 잔액을 조회합니다.

  • 입력: 주소(ENS 이름 지원), NFT 계약 주소, 체인 ID

  • 출력: NFT 잔액 및 메타데이터

  • transfer_nft: ERC721 또는 ERC1155 NFT를 전송합니다.

  • 입력: 수신자 주소(ENS 이름 지원), NFT 계약 주소, 토큰 ID, 체인 ID
  • 출력: 트랜잭션 해시 및 상태

스마트 계약 도구

  • call_contract: 스마트 계약 함수를 호출합니다(읽기 전용).
  • 입력: 계약 주소, 함수 이름, 인수, ABI, 체인 ID

  • 출력: 함수 호출 결과

  • send_contract_transaction: 스마트 계약 함수를 호출합니다(상태 변경).

  • 입력: 계약 주소, 함수 이름, 인수, ABI, 체인 ID
  • 출력: 트랜잭션 해시 및 상태

ENS 도구

  • resolve_ens: ENS 이름을 이더리움 주소로 해석합니다.
  • 입력: ENS 이름

  • 출력: 이더리움 주소

  • lookup_address: 이더리움 주소를 ENS 이름으로 역방향 해석합니다.

  • 입력: 이더리움 주소
  • 출력: ENS 이름(있는 경우)

사용 방법

EVM MCP 서버를 사용하려면:

  1. NPX를 통해 직접 실행(설치 없음): 

    npx @mcpdotdirect/evm-mcp-server

  2. 또는 HTTP 모드로 실행(웹 애플리케이션용): 

    npx @mcpdotdirect/evm-mcp-server --http

  3. 로컬 설치 후 실행: 

    # 저장소 복제
git clone https://github.com/mcpdotdirect/evm-mcp-server
cd evm-mcp-server

# 의존성 설치
npm install

# stdio 서버 시작
npm start

# 또는 HTTP 서버 시작
npm run start:http

  4. Claude Desktop에서 설정 구성: 

    {
  "mcpServers": {
    "evm-mcp": {
      "command": "npx",
      "args": ["@mcpdotdirect/evm-mcp-server"]
    }
  }
}

  5. 또는 HTTP/SSE 엔드포인트에 연결: 

    {
  "mcpServers": {
    "evm-mcp-sse": {
      "url": "http://localhost:3001/sse"
    }
  }
}

사용 사례

EVM MCP 서버는 다음과 같은 시나리오에서 특히 유용합니다:

  1. 블록체인 데이터 분석: 실시간 블록체인 데이터를 조회하고 분석하여 시장 동향, 사용자 행동, 네트워크 활동에 대한 인사이트를 제공합니다.

  2. 멀티체인 상호작용: 다양한 EVM 호환 네트워크에서 일관된 인터페이스를 통해 데이터를 조회하고 트랜잭션을 실행합니다.

  3. 스마트 계약 분석: 스마트 계약 코드를 분석하고 함수를 호출하여 블록체인 애플리케이션을 이해하고 상호작용합니다.

  4. 토큰 관리: ERC20, ERC721, ERC1155 표준 토큰의 잔액을 조회하고 전송하는 작업을 자동화합니다.

  5. ENS 이름 관리: 사람이 읽을 수 있는 ENS 이름을 해석하고 관리하여 블록체인 주소 사용을 단순화합니다.

지원되는 네트워크

EVM MCP 서버는 다음을 포함한 30개 이상의 EVM 호환 네트워크를 지원합니다:

  • 이더리움 메인넷
  • 옵티미즘
  • 아비트럼
  • 폴리곤
  • 바이낸스 스마트 체인(BSC)
  • 아발란체
  • 베이스
  • 팬톰
  • 크로노스
  • 그노시스 체인
  • 기타 다수의 EVM 호환 체인

연결된 구성 요소